Herkes iyi belgelenmiş yazılım geliştirmenin başarıya yol açtığını bilir. Ancak, genellikle UML diyagramı gibi belgede yalnızca düz metinlerin değil ikili içeriğin de yer alacağı anlamına gelir. Birçok insanın bunu söylediğini duydum. Sürüm kontrol sistemi ikili dosyalar için uygun bir yer değildir. Bu konuyu tamamen anlıyorum ve kabul ediyorum. Birkaç tecrübeli geliştiriciye belgeleri depolamak için en iyi yerin nerede olması gerektiğini sordum ve aldığım cevap "wiki" idi. Wiki iyi ama başka bir potansiyel konuyu düşündüm. Bir sürüm kontrol sisteminde depolanan kaynak kodu, wiki'deki ilgili dokümanına nasıl bağlanabilir? Birisinin git veya mercurial deposunu klonladığını varsayalım. Belgeyi kolayca nasıl bulabilir? Yoksa bir şey mi kaçırdım?
Bazı wiki sistemlerinin kaynak kontrol sistemleriyle entegre olabileceğini biliyorum. Ama benim endişem entegrasyon yeteneği ile ilgili değil. Bir git deposundan kaynak kodunu klonladıysanız ve bir süre sonra bir trene bindiğinizde ve trende çevrimdışı çalışmaya devam etmek istiyorsanız (DVCS'nin büyük bir özelliğidir). Sonra aniden trende çevrimdışı çalıştığınız için belgeye erişiminizin olmadığını anlarsınız. Öte yandan, belge git deposunda saklanmışsa, depo klonlanmış belgeye erişebilirsiniz.