Apéndice H — Arquitectura de documentación autoalojada

docs.ionon.ai forma parte de la arquitectura de seguridad y gobernanza, no es sólo un sitio de marketing.

H.1 Fuente de verdad de la documentación

El repositorio recomendado contiene:

/docs
  /concepts
  /architecture
  /identity
  /policy
  /wallet
  /interoperability
  /network
  /economics
  /genesis
  /governance
  /security
  /developers
  /trust
/data
  canonical-registry.json
  tokenomics.json
  chain-status.json
  release-manifest.json
/schemas
  agent-birth-certificate.schema.json
  policy-passport.schema.json
  order.schema.json
  evidence.schema.json
/assets

El CI debe hacer fallar el build si el tokenomics no suma 100M, si las cadenas de contratos canónicos divergen entre páginas, si un estado en vivo carece de enlace de evidencia, si hay enlaces rotos, o si un esquema versionado cambia sin changelog.

H.2 Navegación de la documentación pública

La experiencia externa debe comportarse como un producto premium de clase GitBook permaneciendo totalmente bajo control de IONON:

Overview → Concepts → Architecture → Agent Identity → Policy Engine → Wallet → MCP/A2A → Network → Tokenomics → Genesis → Governance → Security → Developer → Trust Center → Changelog.

El build debe ser estático primero y desplegable tras infraestructura DNS/CDN controlada por IONON. La búsqueda puede generarse localmente desde el corpus de contenido, de modo que la documentación no requiera un proveedor externo de búsqueda SaaS.

H.3 Registro de confianza legible por máquinas

El paquete de documentación debe publicar /data/canonical-registry.json y exponer el mismo contenido desde ionon.ai/verify. Cada entrada lleva cadena, dirección, estado, propósito, URL de evidencia, bloque/versión de activación y estado de obsolescencia.

Referencias

Referencias del whitepaper