Estado de contenidos y capacidades
El Centro de Documentación UbID separa clasificaciones que responden preguntas distintas. Una página puede estar editorialmente completa mientras describe una capacidad planificada, o describir una capacidad disponible mientras su redacción todavía espera revisión especializada.
Estado de capacidad
| Estado | Significado |
|---|---|
| Disponible | Aprobada para uso general dentro del producto, región y condiciones declarados |
| Disponibilidad limitada | Disponible solo para clientes, regiones, entornos o despliegues controlados identificados |
| Preview | Disponible para evaluación; interfaces, comportamiento, soporte o evidencia pueden cambiar |
| Planificada | Dirección aprobada, pero no presentada como disponible actualmente |
| Conceptual | Concepto de arquitectura o investigación sin compromiso de producto |
| Acceso de partners | Capacidad o documentación proporcionada únicamente mediante onboarding controlado |
Una página no debe inferir disponibilidad por la existencia de código fuente, un prototipo, un diagrama de arquitectura o un servicio interno.
Estado editorial
| Estado | Significado |
|---|---|
| Outline | Alcance y límites definidos; el texto público completo está pendiente |
| Foundation | Existe una explicación base sustancial; la revisión especializada y lingüística puede continuar |
| Approved | La versión declarada completó la revisión editorial, temática, de exposición y publicación |
Todas las páginas creadas hasta la Fase 3 permanecen en foundation hasta completar la revisión formal.
Estado de la fuente arquitectónica
Las fuentes institucionales pueden clasificar material como:
- CURRENT — capacidad evidenciada en el entorno validado en la fecha de la fuente;
- REFERENCE — regla, límite o responsabilidad de producto arquitectónica y durable;
- TARGET — evolución prevista, no presentada como ya implementada.
Estos estados de fuente no se traducen automáticamente en disponibilidad de producto. Los responsables de producto, operaciones, seguridad y comercial deben aprobar el estado público de la capacidad.
Nivel de exposición
El modelo de gobierno editorial utiliza:
| Nivel | Regla de publicación |
|---|---|
| Public | Apta para el portal público después de revisión normal |
| Public reviewed | Explicable públicamente, pero exige revisión especializada porque las afirmaciones involucran seguridad, privacidad, regulación, biometría, criptografía o automatización de alto impacto |
| Partner | Documentación controlada para integradores autorizados |
| Internal | Arquitectura, operaciones, riesgos, procedimientos y evidencia para personal autorizado |
| Restricted o secret | Llaves, credenciales, material de recuperación, hallazgos sensibles, acceso privilegiado y demás material que nunca debe entrar en el árbol público de fuentes |
Solo se permiten páginas public y public-reviewed dentro de docs/.
Jerarquía de fuentes
El contenido público debe sustentarse en este orden:
- ley, regulación, orientación de autoridad o estándar normativo oficial y vigente;
- documentos controlados de arquitectura y política UbID aprobados;
- evidencia de implementación y operación validada;
- decisiones aprobadas de producto y disponibilidad;
- material explicativo claramente identificado como no normativo.
Cuando las fuentes se contradigan, la página no debe conciliarlas silenciosamente. El conflicto debe derivarse al responsable correspondiente y la afirmación pública limitarse hasta su resolución.
Metadata de revisión de página
Una página madura debe poder identificar:
- responsable del contenido;
- revisores especializados;
- versiones de fuentes y fecha de cierre de investigación;
- fecha de última revisión;
- estado de capacidad cuando corresponda;
- jurisdicciones y productos dentro del alcance;
- limitaciones conocidas;
- próxima revisión o evento que la active.
No todos los campos deben mostrarse públicamente, pero el registro de aprobación debe existir.
Cambio y deprecación
Los cambios materiales deben actualizar:
- contenido de la página y registro de revisión;
- changelog de documentación;
- estado de la capacidad;
- orientación afectada para partners;
- aviso de migración o deprecación;
- referencias externas;
- traducciones después de aprobar el idioma fuente.
El contenido deprecado debe indicar el reemplazo y la fecha de vigencia. No debe desaparecer cuando usuarios históricos todavía necesiten información de migración.
Seguridad de publicación
La verificación del build público comprueba front matter, valores de exposición, archivos referenciados, assets estáticos y patrones comunes de secretos o direcciones internas. Los controles automatizados reducen errores, pero no reemplazan la revisión humana de seguridad, privacidad, legal, arquitectura y producto.
El portal permanece sin indexación hasta el hito de publicación aprobado.
Consulta el Registro de cambios de la documentación y Gobierno y responsabilidad.