ADR-002: Fuente documental y exportaciones
ADR-002: Fuente documental y exportaciones
Estado
Accepted, 2026-07-14.
Contexto
El producto necesita documentación web, descargas, búsqueda y consumo por IA sin mantener copias divergentes.
Decisión
Markdown en docs es la única fuente editable. Spring Boot escanea metadatos, renderiza HTML con HTML crudo escapado, genera texto, manifiesto, documentos maestros y ZIP. Cada resultado incluye SHA-256 y commit. Los documentos sin front matter se clasifican por ruta para conservar historia sin reescribirla.
Consecuencias
Git controla contenido y revisión. La web es de consulta. Los formatos derivados siempre reflejan la fuente cargada. La regeneración será una acción administrativa cuando exista autenticación. Los documentos críticos, incluida la Constitución, no se editan desde navegador.
ADR-002: Fuente documental y exportaciones Estado Accepted, 2026-07-14. Contexto El producto necesita documentación web, descargas, búsqueda y consumo por IA sin mantener copias divergentes. Decisión Markdown en docs es la única fuente editable. Spring Boot escanea metadatos, renderiza HTML con HTML crudo escapado, genera texto, manifiesto, documentos maestros y ZIP. Cada resultado incluye SHA-256 y commit. Los documentos sin front matter se clasifican por ruta para conservar historia sin reescribirla. Consecuencias Git controla contenido y revisión. La web es de consulta. Los formatos derivados siempre reflejan la fuente cargada. La regeneración será una acción administrativa cuando exista autenticación. Los documentos críticos, incluida la Constitución, no se editan desde navegador.
Información técnica del documento
- Ruta lógica
- adr/ADR-002-documentation-source-and-exports.md
- Commit Git
a83cef9e1ee0c5b0b22662fe3493139d77c23570- SHA-256
19736ea40bb25cd2277b50b3595e84f5f57de99c60109bb2184c3ea56932c338- Regeneración
scripts/build-documentation.sh