Documentación de ESP Platform
Esta carpeta contiene la fuente oficial de documentación de ESP Platform. El producto estable cubierto es ESP Platform Flasher/Backups, versión v0.1.0-flasher-backups.
Fuente única de verdad
Los archivos Markdown versionados en Git son la fuente de verdad. La aplicación los indexa y renderiza para la web, genera texto plano y construye las exportaciones completas. Los formatos derivados nunca se editan manualmente.
Clasificación
- Official: guía vigente para uso, arquitectura, seguridad u operación.
- Historical: decisiones o fases anteriores conservadas como contexto.
- Diagnostic: investigación técnica de un caso concreto.
- Validation: evidencia de pruebas y aceptación.
- ADR: decisión arquitectónica.
- Release: alcance congelado de una versión.
- Internal: planes o plantillas que no describen comportamiento público.
La Constitución conserva su contenido original. Su estado general de presentación es aprobado y congelado, aunque queden textos heredados del proceso de redacción.
Actualización
Toda modificación documental se realiza en esta VM, pasa por scripts/build-documentation.sh, se revisa visualmente y se versiona en Git junto al código que describe.