LINUX.ORG.RU

Literate programming, автогенерация доков из комментов etc.


0

0

У кого есть опыт использования CWEB или чего-то подобного? Поделитесь опытом полезности. Сам использовал Doxygen для последнего проекта - впечатление противоречивое, но вроде есть польза и удобнее держать доки в соответствии с кодом по сравнению с texinfo. Есть ли опыт пользования таких вещей? Кто-нить пользовал NaturalDocs? В общем, давайте обсудим опыт и впечатления.

Надо выбрать способ документации следующего проекта, разрабатываемого командой из 4 разработчиков. Любые частные и общие советы очень приветсвуются.

★★★

Ответ на: комментарий от barbuza

Моё мнение таково, что в итоге весь вопрос сводится к тому, в каком файле писать текст документации. Если его писать в отдельном XML-файле, то можно пользоваться всеми преимуществами XML и не зависеть от ограничений того же Doxygen. Вероятно, "programmers reference manual" всё-таки можно писать без особых проблем и в Doxygen, но вот "user reference manual" в Doxygen писать может быть весьма противно...

yz
()
Вы не можете добавлять комментарии в эту тему. Тема перемещена в архив.