forum.bitel.ru
http://forum.bitel.ru/

Ошибки в доке.
http://forum.bitel.ru/viewtopic.php?f=51&t=6858
Страница 1 из 1

Автор:  aardvark [ 14 июн 2012, 19:12 ]
Заголовок сообщения:  Ошибки в доке.

Ошибки в доке 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) должы быть двоеточия.

Автор:  Phricker [ 14 июн 2012, 20:03 ]
Заголовок сообщения:  Re: Ошибки в доке.

aardvark писал(а):
Вобще у вас не возникала мысль в вику доку перекинуть? Так было гораздо проще ошибки править?

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

Автор:  Администратор [ 15 июн 2012, 16:25 ]
Заголовок сообщения:  Re: Ошибки в доке.

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

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

Автор:  snark [ 20 июн 2012, 16:46 ]
Заголовок сообщения:  Re: Ошибки в доке.

Администратор писал(а):
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.

Автор:  Dog [ 14 фев 2013, 16:56 ]
Заголовок сообщения:  Re: Ошибки в доке.

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

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

Страница 1 из 1 Часовой пояс: UTC + 5 часов [ Летнее время ]
Powered by phpBB® Forum Software © phpBB Group
http://www.phpbb.com/