Una aproximación a la documentación continua.
Descripción
Doc-As-Code se refiere a una filosofía donde usas las mismas herramientas para la documentación que para el código:
- Texto plano con semántica, editable hasta con el editor más simple
- Control de versiones, revisión y merges
- Test (sí, la documentación debería ser testeada también)
En esta charla veremos ejemplos prácticos de diferentes herramientas que nos permitirán alinear nuestro desarrollo con la documentación como son
Asciidoctor,
reveal.js o
Antora y cómo usarlos dentro del proceso de
entrega continua de nuestro
producto.
Público objetivo
Esta charla va dirigida a todo tipo de público, en particular a aquellos desarrolladores que usan el
Manifiesto Ágil como excusa para no documentar sus proyectos.
Ponente(s)
Jorge Aguilera, CPT en
Puravida Software. Desarrollador de software desde hace más de 25 años en
múltiples lenguajes y entornos, apasionado del open source y de Asciidoctor. Ponente asiduo en
MadridGUG y con una charla en
Codemotion 2018.