En Ka0s no tratamos la documentación como un “adjunto”.
La tratamos como parte del sistema.
El Docs Portal (ver core/docs/ka0s_docs_portal/01_concept.md) resume la filosofía:
- la doc vive en el repo (
core/docs), - en Markdown,
- versionada con Git,
- y desplegada automáticamente.
Qué aporta en la práctica
- Cambios revisables en PRs.
- Historial real (quién cambió qué y por qué).
- Búsqueda y navegación modernas.
- Soporte de diagramas (Mermaid) y multimedia.
Por qué es más que “un portal”
La documentación es el contrato entre:
- la operación,
- el desarrollo,
- y el propio agente.
Cuando la doc se versiona como código, la plataforma gana coherencia.