forum.bitel.ru http://forum.bitel.ru/ |
|
Ошибки/опечатки/неточности в существующей документации (CRM) http://forum.bitel.ru/viewtopic.php?f=1&t=4435 |
Страница 1 из 11 |
Автор: | SPY [ 08 июн 2007, 12:20 ] |
Заголовок сообщения: | Опечатки, ошибки |
Решил создать такую тему, поскольку не раз натыкался на ошибки в коде. Конечно все это может сойти за "защиту от дурака", но мне кажется это надо фиксить. Итак: http://www.bgbilling.ru/v4.1/doc/ch05s18.html Цитата: <form method=post action=http://XXX:8080/bgbilling/webexecuter> <input type="hidden" name="midAuth" value=XX><br> <input type="hidden" name="error" value=XXX><br> Должно быть так: Цитата: <form method="post" action="http://XXX:8080/bgbilling/webexecuter">
<input type="hidden" name="midAuth" value="XX"><br> <input type="hidden" name="error" value="XXX"><br> Тоесть пропущены кавычки, может это и не существенно, но для тех кто предпочитает copy/past это может сыграть злую шутку. |
Автор: | vadim s. sabinich [ 06 сен 2007, 08:43 ] |
Заголовок сообщения: | |
Не боишься засыпаться? А сколько ошибок в самом тексте.. Единственный минус - написано в каком-то хтмл-редакторе и поэтому в обычных текстовых редакторах ошибку в html-файле не исправишь. Чтобы отослать дифф/патч. |
Автор: | vadim s. sabinich [ 07 сен 2007, 06:25 ] |
Заголовок сообщения: | file:///D:/bg-billing/bgbilling_4.2_doc/ch07s02.html |
Не совсем понятен этот абзац.. Плюс опечатка. == Далее логи загружаются на сервере в базу данных и обрабатываются. В ходе обработке логи преобразуются из > ОБРАБОТКИ вида: с адреса - на адрес - количество к виду договор - диапазон адресов - тип услуги - ее количество. == |
Автор: | Администратор [ 10 сен 2007, 11:54 ] |
Заголовок сообщения: | |
Это означает что первичные логи вида: с адреса - на адрес - кол-во байт ... агрегируются по часам к виду код диапазона в БД - код услуги - количество байт |
Автор: | vadim s. sabinich [ 11 сен 2007, 15:09 ] |
Заголовок сообщения: | |
Интересно, а если вы выложите документацию на cvs? Я бы поучаствовал в правке документации. Хотя бы относительно опечаток. Потому что постоянно считать строки и выискивать буквы и опечатки ВАМ напряжно, вельми. =) Да и можно будет постоянно скачать обновленную документацию. |
Автор: | Victor [ 30 окт 2007, 15:56 ] |
Заголовок сообщения: | |
http://www.bgbilling.ru/v4.3/doc/ch01s06.html В самом низу: Цитата: mysql -ubill -pbilling bgbilling а нужно: Цитата: mysql -ubill -pbgbilling bgbilling http://www.bgbilling.ru/v4.3/doc/ch01s04.html Ближе к концу: Цитата: 9) Cоздайте службу сервера службу сервера. Для этого откройте скопируйте скрипты из BGBillingServer/script в /etc/rc.d/init.d
|
Автор: | Администратор [ 31 окт 2007, 12:45 ] |
Заголовок сообщения: | |
Исправлено, спасибо. |
Автор: | Администратор [ 14 ноя 2007, 14:46 ] |
Заголовок сообщения: | Ошибки/опечатки/неточности в существующей документации |
По многочисленным жалобам пользователей начата переработка документации. В данный момент переписаны 7 первых глав основного руководства: http://bgbilling.ru/v4.4/doc/ Нам очень важны ваши комментарии и предложения. Основная мысль: построение руководства в виде цельного повествования, позволяющего осваивать биллинг в пошаговом режиме. Одновременно продвинутый пользователь должен иметь возможность быстрого перехода только к нужному блоку информации. |
Автор: | vadim s. sabinich [ 14 ноя 2007, 17:40 ] |
Заголовок сообщения: | |
И первое, что бросается в глаза сразу: документация находится в директории v4.4, а в заголовке - v4.3 |
Автор: | vadim s. sabinich [ 15 ноя 2007, 20:44 ] |
Заголовок сообщения: | |
Далее. Надо все таки определиться, как называется продукт: BG-Billing BGBillinf BG-billing BGbilling и т.п Потому что смотря даже по оглавлению - названия всевозможные. |
Автор: | vadim s. sabinich [ 15 ноя 2007, 23:17 ] |
Заголовок сообщения: | |
Баг-репорт №1 Код: Оглавление:
[b]>>6. Настройка NetFlow агента IPCAD[/b] NetFlow-агента или агента NetFlow [b]>>8. Настройка BGIPNNetFlow коллектора[/b] Аналогично вышесказанному. Или через дефис, или меняем местами слова. [b]>>9. Настройка обработчика логов[/b] log - это журнал. Лог - файл журнала. Ведение логов - журналирование. Может, как-то можно более, гхм, грамотно сформулировать? [b]>>12. Правила файрвола[/b] Или все же "брандмауэр"? Это как-бы более официальный вариант и устоявшийся термин для этого. [b]>>5. WEB - интерфейс[/b] между девисом не должно быть пробелов. И "Web" [b]>>6. WEB - активация[/b] тоже самое, что и выше [b]>>7. Суперкарты[/b] Супер-карты [b]>>8. IVR Система[/b] или дефис, или меняем местами [b]>>10. Генератор логинов и паролей для модуля Карточки[/b] а если "логин" заменить на "имя пользователя"? слово "Карточки" взять в кавычки как название модуля. (относится и к остальным названием модулей) [b]>>14. Модуль Бухгалтерии[/b] Или <<Модуль "Бухгалтерия">>? [b]>>19.6. Возможности WEB - интерфейса модуля[/b] "Web-" [b]>>19.7. Создание договоров пользователем через WEB[/b] ..через Web-форму >>29.5. Настройка shaping-а для трафика WiFi сети. Неужели нет эквивалента слову "shaping" в русском языке? Wi-Fi Плюс, не везде нумерация приведена к единому формату. Где-то: 1. Заголовок 1. Подзаголовок 2. Подзаголовок А где-то 1. Заголовок 1.1. Подзаголовок 1.2. Подзаголовок |
Автор: | stark [ 20 ноя 2007, 21:20 ] |
Заголовок сообщения: | |
vadim s. sabinich писал(а): >>9. Настройка обработчика логов log - это журнал. Лог - файл журнала. Ведение логов - журналирование. Может, как-то можно более, гхм, грамотно сформулировать? Интересно как ? Журналирования (т.е ведения логов), там нет . Там есть загрузка готовых журналов(логов). Если писать вместо лога слово журнал, то мне кажется , это запутает технического специалиста. vadim s. sabinich писал(а): >>12. Правила файрвола Или все же "брандмауэр"? Это как-бы более официальный вариант и устоявшийся термин для этого. Можно поспорить. ИМХО - фаервол понятнее . vadim s. sabinich писал(а): >>10. Генератор логинов и паролей для модуля Карточки
а если "логин" заменить на "имя пользователя"? слово "Карточки" взять в кавычки как название модуля. (относится и к остальным названием модулей) Логин - заменить на имя пользователя .Борьба за чистоту русского языка ? Мне кажется тут она лишней. Читать документацию без траслитираций очень сложно . Мне кажется, что до абсурда доводить не стоит. Остальное постараемся поправить. |
Автор: | vadim s. sabinich [ 20 ноя 2007, 21:46 ] |
Заголовок сообщения: | |
Настройка обработчика файлов журналирования? =) Но.., в принципе, да может ввести путаницу. В этом же роде можно поставить вопрос про слова NAS ("Редактор NAS'ов".. может поискать эквивалент на русском языке? Ну, это я так, дабы рассмотреть все варианты. А как правильно пишется "фаервол", "файрвол", "файервол"?. Но тоже спорный вопрос ) Скорей борьба за то, чтобы вывести отличный продукт из разряда писанных на коленке в разряд Продуктов с большой буквы. Поэтому с моей стороны идут в основном придирки по внешнему виду, по опечаткам, по небольшим ошибочкам. И по документации - естественно. По ней видно, что тот кто писал явно разбирается в вопросе, но ему либо лень все расписывать, либо просто некогда. Много смысловых разрывов, много опечаток. Нам есть над чем поработать! =) |
Автор: | Администратор [ 22 ноя 2007, 18:58 ] |
Заголовок сообщения: | |
Полностью переписаны руководства по основной части биллинга и модулю IPN. Ждем комментариев и замечаний. |
Автор: | vadim s. sabinich [ 22 ноя 2007, 19:40 ] |
Заголовок сообщения: | |
В качестве пожелания еще бы обновить скриншоты и сделать в них более осмысленное содержание. А-то как-то.. гхм.. читать про версию 4.х и видеть скриншоты от 3.х, в которых города "sddd", пользователи "asasdasfffff" и тому подобное. Не серьезно как-то =) |
Автор: | Администратор [ 22 ноя 2007, 19:46 ] |
Заголовок сообщения: | |
Указывайте конкретные места, постараемся учесть. |
Автор: | vadim s. sabinich [ 23 ноя 2007, 10:12 ] |
Заголовок сообщения: | Опечатки и ошибки в программе и модулях |
За неимением ветки форума посвещенной опечаткам и ошибкам как в документации. пишу сюда. Устанаваливаем модуль диалапа: == Module dialup version 4.3 was sucsessfull installed! = |
Автор: | Администратор [ 23 ноя 2007, 14:31 ] |
Заголовок сообщения: | |
fixed |
Автор: | Gankov [ 27 ноя 2007, 04:54 ] |
Заголовок сообщения: | http://bgbilling.ru/v4.4/doc/ch01s04.html |
Страница http://bgbilling.ru/v4.4/doc/ch01s04.html, Абзац: В случае если ваш дистрибутив не предоставляет пакетов, вы можете загрузить универсальные LINUX RPM пакеты на нашем сайте bgbilling.ru. Ссылка в этом абзаце скорей всего должна вести на страницу с загрузкой пакетов, ну или хотя бы на главную страницу сайта, а ведет на туже страницу в документации. |
Автор: | Gankov [ 27 ноя 2007, 08:32 ] |
Заголовок сообщения: | http://bgbilling.ru/v4.4/doc/ch01s04.html |
Еще ошибки в документации 4.4 страница: http://bgbilling.ru/v4.4/doc/ch01s04.html Код: 8) В начале файлов server.sh, bg_installer.sh, data_loader.sh, добавьте пути к JAVA машине: забыли про фаил scheduler.sh, а в него помоему тоже надо добавлять путь, у меня по крайней мере без этого ничего не заработало. Код: 12) Теперь вы можете запустить сервер биллинга выполнив
service bgbilling(bgscheduler, bgdataloader) start Я конечно не большой спец по unix-ам но по моему такая команда не работает, по крайней мере в моем дистрибутиве, может стоит расписать как три команды на три строчки, особенно если это так написано из экономии места. |
Автор: | Gankov [ 27 ноя 2007, 09:05 ] |
Заголовок сообщения: | |
Та же страница, абзац: Код: 8) В начале файлов server.sh, bg_installer.sh, data_loader.sh, добавьте пути к JAVA машине:
cd ${0%${0##*/}}. JAVA_HOME=/opt/java/jre Также проверьте все *.sh файлы на наличие символов ^M и удалите их если есть. Если в системе установлена утилита dos2unix, можно воспользоваться ей: dos2unix *.sh Думаю что в этом пункте или рядом надо написать что на все файлы sh надо дать права на запуск, а то про эти скрипты ничего не сказано, а про другие сказано. |
Автор: | Администратор [ 27 ноя 2007, 15:53 ] |
Заголовок сообщения: | |
Исправлено, спасибо |
Автор: | Администратор [ 27 ноя 2007, 16:03 ] |
Заголовок сообщения: | |
Все исправлено, спасибо. Чуть попозже будет еще обновление. Планируем следующим переписать Phone. |
Автор: | vadim s. sabinich [ 29 ноя 2007, 14:54 ] |
Заголовок сообщения: | |
Зачем убрали описание работы модуля IPN? Философия работы того или иного компонента тоже немаловажна. |
Автор: | Gankov [ 01 дек 2007, 05:13 ] |
Заголовок сообщения: | |
Страница http://bgbilling.ru/v4.4/doc/ch06s06.html Две опечатка. Последний абзац: Теперь данныы атрибут с ограничением трафика будет высылаться всем подключившимся пользовавателям. Расчет атрибута производится исходя из тарифного плана клиента. |
Автор: | Gankov [ 01 дек 2007, 06:21 ] |
Заголовок сообщения: | |
Жалко что на странице установки радиуса http://bgbilling.ru/v4.4/doc/ch06s10.html нету описания про установку на linux, в принципе все по аналогии с установкой сервера, но наверное все таки стоит описать так же пункты установки на линукс, так как набор действий все таки отличается от установки в винде. Это надо хотя бы для того чтобы чего нибудь не забыть сделать, особенно человеку настраивающему билинг первый раз. |
Автор: | Gankov [ 01 дек 2007, 07:16 ] |
Заголовок сообщения: | |
Страница http://bgbilling.ru/v4.4/doc/ch06s03.html абзац, в конце: mailer.to и mailer.period задают почтовый адрес, на который будут слаться ошибки сервера ( не работает SNMP, пришел двойной старт и т.д. ) и период в секундах через который будет слаться отчет об ошибках. Чтобы ошибки слались нужно также настроить опции почты в конфигурации сервера биллинга ( указать почтовый сервер, от кого слать и т.д. ). Если все было сделано правильно, настройка модуля завершена. Может быть стоит заменить слово слались на отправлялись, а то звучит как-то по дурацки. |
Автор: | Gankov [ 01 дек 2007, 07:28 ] |
Заголовок сообщения: | |
Страница: http://bgbilling.ru/v4.4/doc/ch06s06.html На странице нигде не указано, в какой пункт меню надо зайти чтобы открылось окно настройки насов. При первом знакомстве с системой не понятно где это искать. |
Автор: | Gankov [ 01 дек 2007, 08:30 ] |
Заголовок сообщения: | |
Страница: http://bgbilling.ru/v4.4/doc/ch06s05.html Абзац: 1) быстрого назначения определенного набора опций логину, не перечисляя каждый раз все атрибуты (например, ACL список либо скорость соединения) (см. далее настройку клиентов); 2) задания опций работы для тарифного плана (см. далее настройку тарифов). Может быть в месте где написано см. далее сразу ссылку на эти страницы дать, все таки HTML а не книжка. Страница: http://bgbilling.ru/v4.4/doc/ch06s15.html Место: Начиная с 4.0 версии в тарифных планах возможна установка группы RADIUS атрибутов, передаваемых в AUTH ACCEPT пакете. Например, это можнет использоваться для заужения канала клиента в зависимости от потребленного им трафика в течении месяца. Пример подобного тарифа приведен ниже. Где нибудь в этом месте хотелось бы видеть рекомендации и\или последовательность действий для того чтобы заработало ограничение по скорости и сразу ссылки на странички где это настраивать, такие как страничка с настройками группы атрибутов и настройками радиуса. А еще лучше если а каком нибудь месте будет отдельная инструкция по последовательности действий для настройки ограничения, а то приходится самому рыскать по всей и документации где же чего надо прописать. И еще в выделенном абзаце есть опечатки, может быть стоит всю инструкцию проверить на орфографию, например в ворде, а то очень часто опечатки встречаются. |
Автор: | Gankov [ 01 дек 2007, 08:55 ] |
Заголовок сообщения: | |
Тут я поспешил, но удалить пост к сожалению уже не могу. |
Страница 1 из 11 | Часовой пояс: UTC + 5 часов [ Летнее время ] |
Powered by phpBB® Forum Software © phpBB Group http://www.phpbb.com/ |