Подскажите, в чём вести документацию проекта, написанного на PHP?
Вики не подошли по разным причинам: MediaWiki громоздкая, много лишнего и неудобное форматирование; Redmine сваливает всё в кучу, не даёт создать нормальную иерархию и проблемы с форматированием. Также отклонены были TikiWiki и DocuWiki.
Help & Manual хорошо создаёт структуру, но опять же бедное форматирование и бедная подсветка синтаксиса, даже если раскрасить custom схему.
Doc-o-matic громоздок и поддержка PHP сделана постольку-поскольку. В целом, хорошая софтина, но держит документацию или в шаблонах, или в исходниках, что неприемлемо. И вывод HTML представляет собой опять же свалку без поиска.
Системы автодокументирования не подходят, т.к. нужна более дружелюбная документация. Inline-документация, разумеется, есть, но это не то.
Написание документации в ворде с сохранением в PDF это лучше, чем ничего, но хотелось бы работать удобнее. Буду благодарен, если назовёте альтернативы перечисленным программам.
Вики не подошли по разным причинам: MediaWiki громоздкая, много лишнего и неудобное форматирование; Redmine сваливает всё в кучу, не даёт создать нормальную иерархию и проблемы с форматированием. Также отклонены были TikiWiki и DocuWiki.
Help & Manual хорошо создаёт структуру, но опять же бедное форматирование и бедная подсветка синтаксиса, даже если раскрасить custom схему.
Doc-o-matic громоздок и поддержка PHP сделана постольку-поскольку. В целом, хорошая софтина, но держит документацию или в шаблонах, или в исходниках, что неприемлемо. И вывод HTML представляет собой опять же свалку без поиска.
Системы автодокументирования не подходят, т.к. нужна более дружелюбная документация. Inline-документация, разумеется, есть, но это не то.
Написание документации в ворде с сохранением в PDF это лучше, чем ничего, но хотелось бы работать удобнее. Буду благодарен, если назовёте альтернативы перечисленным программам.