Todos saben que el desarrollo de software bien documentado conduce al éxito. Sin embargo, generalmente significa que no solo el texto simple sino también el contenido binario estarán involucrados en el documento, como un diagrama UML. Y he escuchado a mucha gente decir eso. El sistema de control de versiones no es el lugar apropiado para los archivos binarios. Entiendo totalmente y estoy de acuerdo con el tema. Pregunté a varios desarrolladores experimentados dónde debería estar el mejor lugar para almacenar documentos y la respuesta que obtuve fue "wiki". Wiki es bueno, pero consideré otro problema potencial. ¿Cómo se puede conectar el código fuente que se ha almacenado en un sistema de control de versiones a su documento relacionado en wiki? Digamos que alguien clona el repositorio de git o mercurial. ¿Cómo puede él / ella encontrar el documento fácilmente? ¿O acabo de perder algo?
Sé que algunos sistemas wiki tienen la capacidad de integrarse con los sistemas de control de código fuente. Pero mi preocupación no es sobre la capacidad de integración. Si ha clonado el código fuente de un repositorio git y después de un tiempo se sube a un tren y desea continuar trabajando sin conexión en el tren (que es una gran característica de DVCS). Entonces, de repente te das cuenta de que no tienes acceso al documento ya que estás trabajando sin conexión en el tren. Por otro lado, si el documento se almacenó en el repositorio de git, tendría acceso al documento con el repositorio clonado.