Semua orang tahu bahwa pengembangan perangkat lunak yang terdokumentasi dengan baik mengarah pada kesuksesan. Namun, itu biasanya berarti bahwa tidak hanya teks biasa tetapi juga konten biner akan terlibat dalam dokumen, seperti diagram UML. Dan saya pernah mendengar banyak orang mengatakan itu. Sistem kontrol versi bukan tempat yang tepat untuk file biner. Saya benar-benar mengerti dan setuju dengan masalah ini. Saya bertanya kepada beberapa pengembang berpengalaman di mana tempat terbaik untuk menyimpan dokumen dan jawaban yang saya dapatkan adalah "wiki". Wiki bagus tapi saya menganggap masalah potensial lain. Bagaimana kode sumber yang telah disimpan dalam sistem kontrol versi dapat terhubung ke dokumen terkait di wiki? Katakanlah seseorang mengkloning repositori git atau mercurial. Bagaimana dia bisa menemukan dokumen dengan mudah? Atau apakah saya baru saja melewatkan sesuatu?
Saya tahu beberapa sistem wiki memiliki kemampuan untuk berintegrasi dengan sistem kontrol sumber. Tetapi kekhawatiran saya bukan tentang kemampuan integrasi. Jika Anda telah mengkloning kode sumber dari repositori git dan setelah beberapa saat Anda naik kereta dan ingin terus bekerja offline di kereta (yang merupakan fitur besar DVCS). Kemudian Anda tiba-tiba menyadari bahwa Anda tidak memiliki akses ke dokumen karena Anda bekerja offline di kereta. Di sisi lain, jika dokumen disimpan di repositori git Anda akan memiliki akses ke dokumen dengan repositori yang dikloning.