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
| Criticidad | Tipo de documento | SLA máximo sin revisión |
|---|
| Alta | OpenAPI, seguridad, runbooks, DB schema | 14 días |
| Media | Documentos de producto, trazabilidad, arquitectura | 30 días |
| Baja | Glosarios, guías de onboarding, contexto general | 60 días |
3. SLO del programa
| Indicador | Objetivo |
|---|
| Docs de criticidad alta dentro de SLA | >= 98% |
| Docs de criticidad media dentro de SLA | >= 95% |
| Docs vencidas (> SLA) por más de 2 ciclos | 0 |
4. Proceso de control
- Auditoría mensual de
last_updated.
- Clasificación por criticidad.
- Plan de remediación con owner y fecha.
- 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.