Saltar al contenido principal

SLA/SLO de Frescura Documental

1. Objetivo​

Garantizar que la documentación relevante para diseño, desarrollo y operación esté actualizada en tiempos compatibles con el ritmo de cambios.

2. Criticidad y ventanas máximas​

CriticidadTipo de documentoSLA máximo sin revisión
AltaOpenAPI, seguridad, runbooks, DB schema14 días
MediaDocumentos de producto, trazabilidad, arquitectura30 días
BajaGlosarios, guías de onboarding, contexto general60 días

3. SLO del programa​

IndicadorObjetivo
Docs de criticidad alta dentro de SLA>= 98%
Docs de criticidad media dentro de SLA>= 95%
Docs vencidas (> SLA) por más de 2 ciclos0

4. Proceso de control​

  1. Auditoría mensual de last_updated.
  2. Clasificación por criticidad.
  3. Plan de remediación con owner y fecha.
  4. Escalamiento en comité operativo si hay incumplimiento repetido.

5. Controles automatizados mínimos​

  • Validación de front matter en CI (lint:frontmatter).
  • Validación de regresión de versión (lint:version-regression).
  • Build de docs obligatorio en PR.

6. Tratamiento de incumplimiento​

  • Primer incumplimiento: acción correctiva en backlog de la semana.
  • Segundo incumplimiento consecutivo: prioridad P1 y seguimiento semanal.
  • Tercer incumplimiento consecutivo: bloqueo de release del módulo afectado hasta corrección.