Bagaimana dengan sesuatu seperti Sphinx ?
Anda menulis dokumentasi Anda di reStructuredText (sintaksnya mirip dengan Markdown, yang digunakan Stack Overflow) ke dalam file teks biasa (= kontrol versi yang mudah) dan Sphinx memuntahkan halaman HTML.
Dua pengguna Sphinx yang paling menonjol (yang saya tahu) adalah bahasa Python dan TortoiseHG (lihat tautan untuk dokumentasi yang dihasilkan Sphinx).
EDIT:
Saya baru saja membaca bahwa Anda berbicara tentang dokumentasi internal proyek, bukan dokumentasi pengguna akhir.
Menurut pendapat saya, sesuatu seperti Sphinx adalah cara terbaik untuk dokumentasi internal juga (asalkan Anda bisa membuat analis Anda menulis reStructuredText) karena:
- Anda dapat dengan mudah mengontrol versi dokumen (dan file teks yang berbeda membutuhkan banyak ruang, jauh lebih sedikit daripada file biner seperti .doc atau .pdf).
- Jika pengembang menginginkan file .doc atau .pdf yang dapat dibaca, ia dapat membuatnya dengan Sphinx dari sumbernya.
Jika Sphinx terlalu rumit, bahkan ada cara yang lebih mudah: Anda dapat menulis dokumentasi Anda di Markdown dan menggunakan Pandoc untuk membuat (misalnya) file .rtf, .doc atau .pdf (ini dapat melakukan lebih banyak lagi).
Saya menemukan Pandoc lebih mudah untuk memulai daripada Sphinx, tetapi Pandoc tidak dapat membuat hierarki menu yang bagus seperti Sphinx (seperti dalam dokumentasi Python dan TortoiseHG yang saya tautkan di atas).
Apa pun alat yang Anda gunakan, jika Anda memiliki server web internal dan server build, Anda dapat mengaturnya sehingga server build menghasilkan output HTML dan menyalinnya di server web setiap kali seseorang mendorong sesuatu ke dokumentasi. Jadi analis Anda bahkan tidak perlu memikirkan hasil akhir, mereka hanya perlu berkomitmen dan mendorong perubahan mereka.