roboforum.ru

LaTeX + VCS не предлагать?

Это было первое что пришло в голову. Сам писал когда-то доки в латехе. Но боюсь это отпугнет потенциальных контрибуторов. Вики как-то более понятно

Второе что приходит в голову — docbook
но это пожалуй сложнее латеха будет.

Тоже знакомо, довелось как-то поучаствовать в переводе документации PHP на русский

Но гемора тоже много для рядового юзера. Пока что вики представляется наиболее приемлемым вариантом.

А мне пока предстаёт более правильным вариантом пока тупо .odt-файлы вести и OpenOffice всем поставить

И вообще не верю я в толпы людей дописывающие 1 инструкцию так, чтобы она целостной осталась

Программы так пишут, а книги не видел чтобы так писали. И стиль и подход начинают прыгать тогда от главы к главе...

Проблема в том, что вот ты выкладываешь новую версию - и непонятно что в ней изменилось. На словах описать это хорошо, а наглядно увидеть - в 100 раз лучше. Это хорошо пока доки маленькие, а в дальнейшем что-то покрупнее может быть.

Вики чем не книга? И ее очень даже используют для документации. И как раз удобно - авторы пишут, а редактор может глянуть чего они там понаписали - и подправить стиль и слог, без рысканья по всему документу в поисках изменений.

Вообще в odt можно сохранять версии.

Как вариант можно держать и сам odt под контролем версий,
но это не лучшая идея.

Можно использовать docuwiki — весьма приятная вика для документации,
и плюс хранит данные в простых текстовиках.

Добавлено спустя 3 минуты 51 секунду:
Re: Обсуждение модулей OpenRobotics - общие вопросы, распространение
Но все равно придется использовать конвертер html2pdf.

PS: искал в гугле let me google that for you: odf система контроля версий и нашел довольно полезный пост:
http://alenacpp.blogspot.com/2008/01/wiki.html (Блог Ивана я дано читаю...)

а что c LCD под ОR?не могу найти тему, вроде была такая.

viewtopic.php?f=35&t=4851&hilit=%D0%BA%D0%BB%D0%B0%D0%B2%D0%B8%D0%B0%D1%82*

В производство сдадим как новогодние каникулы закончатся.

Может Google Docs?

Хороший вариант, но последний раз, когда смотрел, жрало процессор жутко.
Хотя наверное оптимизировали уже.

Перекроил основную страницу проекта в вике - [[OpenRobotics]], разбил на страницы, сделал почти минисайт в вике

Добавлено спустя 1 минуту 35 секунд:
Re: Обсуждение модулей OpenRobotics - общие вопросы, распространение
Есть мысль отделить все темы по разработке и развитию от тем по модулям. Может быть даже пока их обратно в проекты перетащить.

О совсем другое дело, спсб.

Почистил раздел форума OpenRobotics от тем по разработке и т.п.

на главную страницу-то забыли добавить