Whitepaper V4.1
27. La documentación como infraestructura
La documentación de IONON se genera desde una fuente canónica y un registro legible por máquina, no se reescribe manualmente en cinco sitios web.
docs.ionon.ai debe ser autoalojado. El repositorio contiene Markdown/MDX, registros de contratos, esquemas JSON, manifiestos de release y assets estáticos. CI valida enlaces rotos, discrepancias de direcciones de contratos, sumas de tokenomics, números de versión y etiquetas de estado antes de publicar.
V4 añade controles de release verificables por máquina: cada release de documentación produce un manifiesto con hashes SHA-256 del whitepaper, los registros y los esquemas; CI rechaza la publicación si los tokenomics no suman 100 %, una dirección canónica diverge entre páginas, una afirmación VERIFIED-PUBLIC carece de URL de evidencia, o una dirección obsoleta aparece sin etiqueta de deprecación.
El paquete de documentación autoalojado debe incluir /.well-known/security.txt, /.well-known/ionon.json, archivos JSON Schema para identidad/política/orden/evidencia, un contrato OpenAPI para las interfaces públicas cuando esos endpoints se liberen, notas de release firmadas, sitemap/robots y un índice de búsqueda local, de modo que la documentación pueda operar sin un SaaS de documentación de terceros.
La documentación pública debe exponer:
- Conceptos;
- Arquitectura;
- Agent Identity;
- Policy Engine;
- Wallet & Money Router;
- Integración MCP y A2A;
- IONON Network;
- Tokenomics;
- Genesis CCA;
- Gobernanza;
- Seguridad;
- APIs de desarrollador;
- Contratos canónicos;
- Trust Center;
- Notas de release;
- Divulgaciones de riesgo.