Подскажите сервис/приложение для написания документации

347
.
brainhub

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

.

lazyproger, по API - Doxygen
пользовательская - глянь это

.

lazyproger, Язык какой? opensource/closedsource?

Для API документации есть куча средств под каждый язык. Doxygen конечно может быть и крут, но лучше, когда есть что-то специально заточенное под конкретный язык.

В питоне однозначно рулит sphinx-doc, а вместе с rtfd они составляют довольно не плохую платформу для документирования opensource проектов.

В пыхе есть всеми известный PHPDoc, ещё есть Sami от Sensiolabs.

В go так вообще всё из коробки есть.

Что касается пользовательской, вряд-ли можно что-то посоветовать. Тут только пробовать самому. Я предпочитаю использовать генераторы статических сайтов, которые из *.md/*.rst файлов могут сгенерировать набор html-ек. Вот ещё интересная штука пилится: https://github.com/docpress/docpress правда WIP, но попробовать думаю уже можно.

Всего: 3