¡Hola comunidad!
En el pasado, la documentación técnica del código fuente y de los productos de software se generaba en archivos chm, pdf y generadores de documentación de los propios lenguajes de programación. Este enfoque antiguo tenía las siguientes limitaciones:
- Documentación obsoleta,
- Documentación no interactiva y difícil de consultar,
- Diseño poco amigable y que no se adhiere a HTML,
- Imposibilidad de personalizar el diseño de los documentos,
- Imposibilidad de tener documentación en HTML 5 online y offline.
- Falta de soporte a Markdown.
Hoy en día, existen varias soluciones de generación de documentación que producen Portales de Documentación Web muy atractivos, interactivos y con opciones estáticas y dinámicas, con soporte total para HTML 5 y más recientemente Markdown.
Consulta la tabla con las opciones de código abierto más populares: