Git y documentation

Cuando intenta fusionar un .docx con git, no es siempre hermoso.

Es incluso peor si intenta fusionar una image o algunos documentos PDF.

Tenía algunas ideas como:

  1. una persona trabajando en un documento en ese momento y luego presionando de inmediato,
  2. siempre jale antes de empujar y vea qué otras personas cambiaron luego se fusionan manualmente y empujan
  3. no usando git para la documentation …

Entonces mi pregunta es, ¿cómo gestionas tu documentation con git?

Simple: para la documentation, use un formatting de text sin formatting, que es para lo que se creó git. Puede usar LaTeX, Sphinx, Markdown o cualquier otra cantidad de cosas. Los formattings XML desorderados como .docx no se fusionarán bien.

Utilizo un formatting de text, como Docbook o TeX o HTML o (gasp) para mi documentation.

Docbook en particular genera muchos formattings de salida (HTML, PDF, etc.) y es una gran manera estandarizada de escribir documentation.

También puede usar la synchronization externa para pasar tokens de actualización virtual. Coordinamos en IRC o correo cuando tenemos que hacer cosas que pueden entrar en conflicto.

Puede seguir el ejemplo del proyecto Git: escribieron el manual del usuario en AsciiDoc .

La respuesta inútil es: No trates de hacer tales fusiones. Use una herramienta de diferencia externa que sea adecuada para el formatting del problema. O, como ya ha dicho otro, use un formatting que sea susceptible de tener una antigua combinación sencilla que no cause dolor.