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/ |