El día de hoy me encontré con una información relevante que me gustaría compartir.

La manera de documentar y generar contenido, que comunmente realizo, es mediante este blog. Pero siempre me encontraba con la barrera de realizar una documentación un poco más ámplia, como enlazar el contenido con otro archivo, y así.

Bien, ahora me encontré con dos herramientas que se menciona tiene este tipo de funcionalidad, y es recomendado para realizar documentación de material tecnológico. Estas son: asciidoc y reStructeredText.

A una simple vista pienso realizar pruebas correspondientes con asciidoc aunque reStructureText parece tentador, pues tiene una manera de desarrollarlo con Python.

Me parece muy buenas alternativas libres, donde se puede realizar la documentación de software y manuales. Además que asciidoc es utilizada por usuarios linux (siendo yo uno de ellos). Quiero realizar las pruebas respectivas.

Enlaces a los softwares

Fuente

  • Book - Modern Technical Writing by Andrew Etter