BiTel

Форум BiTel
bgbilling.ru     docs.bitel.ru     wiki.bitel.ru     dbinfo.bitel.ru     bgcrm.ru     billing.bitel.ru     bitel.ru    
Текущее время: 25 апр 2024, 16:20

Часовой пояс: UTC + 5 часов [ Летнее время ]




Начать новую тему Ответить на тему  [ Сообщений: 5 ] 
Автор Сообщение
 Заголовок сообщения: Ошибки в доке.
СообщениеДобавлено: 14 июн 2012, 19:12 
Не в сети

Зарегистрирован: 22 дек 2008, 13:02
Сообщения: 270
Откуда: Москва
Карма: 27
Ошибки в доке BGCRM кидать в отдельное место или в общую кучу/тему о BG доке?
Вобще у вас не возникала мысль в вику доку перекинуть? Так было гораздо проще ошибки править?
Глава 2. Раздел 2. Подраздел 2.1 первый пример
Код:
bgbilling:server.<n>.id=<id>
bgbilling.server.<n>.title=<title>
bgbilling.server.<n>.url=<url>
bgbilling.server.<n>.version=<version>
bgbilling.server.<n>.customerIdParam=<paramId>

Со второй строки вместо первой точки в строке (после слова bgbilling) должы быть двоеточия.


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Ошибки в доке.
СообщениеДобавлено: 14 июн 2012, 20:03 
Не в сети
Клиент
Аватара пользователя

Зарегистрирован: 29 мар 2010, 23:11
Сообщения: 5854
Карма: 472
aardvark писал(а):
Вобще у вас не возникала мысль в вику доку перекинуть? Так было гораздо проще ошибки править?

Думаю самим разработчикам не проще было бы. Хотя кто знает кто знает

_________________
Цитаты великих людей :umnik:
Напишите в helpdesk © stark
повторяю: => хелпдеск => доработка => профит © dimOn
свершилось... © skn
Мой код изящен, лёгок, оригинален, краток. Как прохладный весенний ветерок, как звонкий ручей! © dimOn
Вежливый разработчик © Artur
Эти баги тоже исправлены, как и те, которые еще не написаны © Artur
ну т.е. существует воркэраунд, ок © dimOn


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Ошибки в доке.
СообщениеДобавлено: 15 июн 2012, 16:25 
Не в сети
Разработчик

Зарегистрирован: 27 ноя 2006, 20:36
Сообщения: 5715
Карма: 93
Эксперементировали с WiKi. Неудобно получается доку писать в ней. Первую версию даже написали.. Потом вернулись.
Пробовали и docuwiki и пр.
Неудобства:
1) Нет автосодержания.
2) Приходится придумывать постоянно названия статей, фактически иерархии же нет в статьях.
3) Нет возможности как в DocBook быстро "тасовать" структуру, перенося блоки из раздела в раздел.
4) Нет возможности отслеживать изменения глобально по документации, в DocBook исходники доки хранятся просто в виде XML ки.
5) Нудобно делать ссылки в документации на другие разделы.

К документации надо попробовать приделать Orphus, как вроде snark предлагал. Оптимальный вариант, по-моему..


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Ошибки в доке.
СообщениеДобавлено: 20 июн 2012, 16:46 
Не в сети
Клиент

Зарегистрирован: 12 фев 2008, 18:10
Сообщения: 3951
Карма: 249
Администратор писал(а):
1) Нет автосодержания.

"Заглавная страница"(tm), правда оно только для одной версии, а для разных, то, например, так


Администратор писал(а):
2) Приходится придумывать постоянно названия статей, фактически иерархии же нет в статьях.

Названия все равно надо будет придумывать, что в вики, что в доке ;)
Педивикия вроде как с иерархией, не?


Администратор писал(а):
3) Нет возможности как в DocBook быстро "тасовать" структуру, перенося блоки из раздела в раздел.

Может я чего не понял, но в чем проблема тасовать такую структуру?
Код:
== Раздел 1 ==
=== Подраздел 1 раздела 1 ===
=== Подраздел 2 раздела 1 ===
=== Подраздел 3 раздела 1 ===
== Раздел 2 ==
=== Подраздел 1 раздела 2 ===
=== Подраздел 2 раздела 2 ===
=== Подраздел 2 раздела 2 ===



Администратор писал(а):
4) Нет возможности отслеживать изменения глобально по документации, в DocBook исходники доки хранятся просто в виде XML ки.

diff-ить не удобно - это да, но зато для каждой статьи записывается каждый чих.


Администратор писал(а):
5) Нудобно делать ссылки в документации на другие разделы.

Код:
Ссылка на [[раздел]] прямо в тексте.

Нажатие приведет нас в:
Код:
http://wiki.example.com/Раздел



Администратор писал(а):
К документации надо попробовать приделать Orphus, как вроде snark предлагал.

Он то предлагал (я скромный, ага), а тема про ошибки все пухнет и пухнет.
По правде говоря орфографические ошибки aka очепятки - это не самое главное! Главное чтобы БГБ стремился в будущее, ну а разработчики, когда есть свободное время (кто бы что ни думал, но ящитаю, что они люди и у каждого из них одна голова и всего две руки), заходили в тему про ошибки в доке и выпиливали ошибки. Ведь если спросить любого: "тебе чо важно, чтобы БГБ работал без глюков и имел много фишек или чтобы в доке было написано "копировать" вместо "капиравать"?", то ответ будет более чем очевиден, IMHO.


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Ошибки в доке.
СообщениеДобавлено: 14 фев 2013, 16:56 
Не в сети
Клиент

Зарегистрирован: 21 сен 2009, 13:01
Сообщения: 835
Откуда: Москва
Карма: 15
aardvark писал(а):
Ошибки в доке BGCRM кидать в отдельное место или в общую кучу/тему о BG доке?
Вобще у вас не возникала мысль в вику доку перекинуть? Так было гораздо проще ошибки править?
Глава 2. Раздел 2. Подраздел 2.1 первый пример
Код:
bgbilling:server.<n>.id=<id>
bgbilling.server.<n>.title=<title>
bgbilling.server.<n>.url=<url>
bgbilling.server.<n>.version=<version>
bgbilling.server.<n>.customerIdParam=<paramId>

Со второй строки вместо первой точки в строке (после слова bgbilling) должы быть двоеточия.


не все поправили с этой ошибкой:

Код:
bgbilling:server.1.id=bitel
bgbilling:server.1.title=BiTel
bgbilling:server.1.url=http://billing.office.bitel.ru/executer
bgbilling:server.1.version=5.2
bgbilling.server.1.customerIdParam=100

последняя строчка


Вернуться к началу
 Профиль  
 
Показать сообщения за:  Поле сортировки  
Начать новую тему Ответить на тему  [ Сообщений: 5 ] 

Часовой пояс: UTC + 5 часов [ Летнее время ]


Кто сейчас на конференции

Сейчас этот форум просматривают: нет зарегистрированных пользователей и гости: 1


Вы не можете начинать темы
Вы не можете отвечать на сообщения
Вы не можете редактировать свои сообщения
Вы не можете удалять свои сообщения
Вы не можете добавлять вложения

Найти:
Перейти:  
cron
POWERED_BY
Русская поддержка phpBB
[ Time : 0.131s | 28 Queries | GZIP : On ]