Всім відомо, що добре задокументована розробка програмного забезпечення веде до успіху. Однак зазвичай це означає, що в документі буде задіяний не лише звичайний текст, а й двійковий вміст, наприклад діаграма UML. І я чув, як багато людей це говорять. Система управління версіями не є відповідним місцем для бінарних файлів. Я цілком розумію і погоджуюся з цим питанням. Я запитав декількох досвідчених розробників, де найкраще місце для зберігання документів, і я отримав відповідь «вікі». Wiki хороший, але я розглядав ще одне потенційне питання. Як вихідний код, який зберігається в системі управління версіями, може з'єднуватися з відповідним документом у вікі? Скажімо, хтось клонує сховище git або mercurial. Як він / вона може легко знайти документ? Або я просто щось пропустив?
Я знаю, що деякі системи wiki мають можливість інтегруватися з системами управління джерелами. Але моя стурбованість не полягає у здатності інтеграції. Якщо ви клонували вихідний код із сховища git і через деякий час ви сідаєте в поїзд і хочете продовжувати працювати в режимі офлайн у поїзді (що є великою особливістю DVCS). Тоді ви раптом зрозумієте, що у вас немає доступу до документа, оскільки ви працюєте в автономному режимі в поїзді. З іншого боку, якби документ зберігався у сховищі git, ви мали б доступ до документа із клонованим сховищем.