Doc-as-Code

Documentation As Code se refiere a una forma de tratar la documentación como si fuera código.

Es decir, en lugar de usar procesadores de texto que generan ficheros binarios y que están más orientados a la presentación que al texto en sí, usar editores de texto plano con una sintáxis orientada a la semántica. Esto nos permitirá versionar la documentación en repositorios similares al código, pudiendo crear ramas, revisiones, merges, pull request, etc.

Así mismo usaremos las mismas herramientas que usamos para el código para desplegarlo: pipelines, "compilaciones" (sí, la documentación también se puede "compilar"), desplieges automáticos, etc

Slides