яку систему онлайн-технічної документації ви б рекомендували? [зачинено]

мета полягає в створенні системи онлайн-документації з такими основними вимогами:

• в основному буде використовуватися як проміжна стадія для кінцевих технічних документів усієї нашої програми (яка, ймовірно, ніколи не завершиться, хоча:]). Зазвичай це використовується так: у когось є проблема, я її виправляю і записую виправлення негайно. Те, що відбувається зараз, стає немислимим: у когось є проблема, я її вирішую, і я, і хтось щасливий, але через 2 місяці у когось іншого є така ж проблема, і ніхто не пам’ятає, що було виправлено.
• доступ звідусіль, працює за нашим сервером apache
• управління користувачами / групами, що дозволяє доступ лише для читання / читання-запису / адміністратора
• формат не надто важливий: звичайний текст зробив би, хоча в стилі вікі було б приємніше
• дешево або безкоштовно

кілька моїх ідей:

• просто обслуговуйте файли на спільному файлі або через ssh (мінуси: не надто сумісні з Windows, плюси: простий, може бути будь-який тип файлу)
• зберігайте його в SCM (svn / git, idem, як вище, але простіший доступ і контроль доступу)
• Злиття: ми вже використовуємо Джиру, чи вартує Конфлуенс? Як вона інтегрується з Джирою?
• щось ще?

Не соромтеся коментувати це або поділіться своїм досвідом з іншими системами.

Я збирався запропонувати Wiki

Оскільки Confluence - це вікі, я думаю, що використовувати її разом із вашим JIRA - це відмінна ідея. Ви матимете перевагу в тому, що зможете безпосередньо пов'язатись із проблемами JIRA, а отже, фактичним кодом / документом / будь-якими змінами, внесеними тощо.

Ключ до будь-якого коду doc repo, як це - навігаційний аспект. Ви не хочете, щоб сторінки, які від’єднуються, важко знайти тощо. Думайте про "макет сайту" так, як ви хотіли б для веб-сайту.