Какой движок использовать для ведения документации по программе?

Question

[dogovor]

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

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

Очень похожа по функционалу библиотека https://technet.microsoft.com/ru-ru/library/aa9915...

Существуют ли opensource аналоги. Wiki движки не вполне заточены под это, но если есть примеры реализации буду признателен.

Answer 1

[Эдуард Тибет]

Сначала определитесь, какой формат вам необходим. Это можно сделать по _полным_ требованиям к документации и сравнением "требования <> возможности формата".

В общем случае под ваши требования:

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

подпадает любой src-based формат (неважно, plain text или xml-based), который можно хранить в ветках в дереве SCM.

Answer 2

[nelolka]

daux.io
Оно?

Answer 3

[Алекс Глебов]

https://sphinx-ru.readthedocs.io/ru/latest/

Answer 4

[Станислав Салангин]

- asciidoc + Docbook
- DITA + OT или Ant , редакторы Serna или Oxygen

Comments

[Эдуард Тибет]

Не совсем понятно, зачем в п.1 два формата со знаком плюс, хотя они работают раздельно.
Т.е. у вас в п.1 и в п.2 плюсуются компоненты с разным предназначением.