LINUX.ORG.RU

История изменений

Исправление Deleted, (текущая версия) :

Исходя из большого списка проектов, которые используют сфинкс (а значит и хороших песпектив его развития), успешные альтернативы будут включать только непосредственно написание документации в необходимых форматах. Т.е. выбрать нужные форматы и делать документацию вручную. Поскольку не все форматы необходимы, то можно ограничиться LaTeX и man и поступиться документацией html, потому что её, как мне кажется, делать сложнее. Это для инструкций по использованию. А для описания файлов, модулей, классов, пространств имен используется doxygen.

Исправление Deleted, :

Исходя из большого списка проектов, которые используют сфинкс (а значит и хороших песпектив его развития), успешные альтернативы будут включать только непосредственно написание документации в необходимых форматах. Т.е. выбрать нужные форматы и делать документацию вручную. Поскольку не все форматы необходимы, то можно ограничиться LaTeX и man и поступиться документацией html, поскольку её, как мне кажется, делать сложнее. Это для инструкций по использованию. А для описания файлов, модулей, классов, пространств имен используется doxygen.

Исходная версия Deleted, :

Исходя из списка проектов, которые используют сфинкс (а значит и песпектив его развития), альтернативы будут включать только непосредственно написание кода в необходимых форматах. Т.е. выбрать нужные форматы и делать документацию вручную. Поскольку не все форматы необходимы, то можно ограничиться LaTeX и man и поступиться документацией html, поскольку её, как мне кажется, делать сложнее.