00 · Principios

Umbral es un laboratorio de datos independiente y de código abierto. Publica sobre desapariciones, delito y gasto público en México. Todo lo que aquí se define es vinculante salvo que un humano indique lo contrario.

Umbral = el punto donde la evidencia se vuelve significativa.

Los cinco principios

1. El título es la afirmación. Una gráfica se titula con el hallazgo, no con el tema, y el hallazgo tiene que sostenerse con lo que la gráfica muestra. Si el título dice algo que la figura no puede probar, la figura está decorando una afirmación que nadie verificó.

2. La incertidumbre es visible. Intervalos en las proyecciones, IC en las estimaciones, n y denominador en las tasas. Un estimado puntual sin intervalo afirma una precisión que el método no tiene. Es la firma del laboratorio: se reconoce una gráfica de Umbral porque muestra lo que no sabe.

3. Los huecos se declaran. El dato faltante es información. Interpolarlo, rellenarlo con cero o recortar el periodo hasta que desaparezca cambia la conclusión sin que el lector pueda saberlo.

4. El lenguaje causal es deliberado. «Asociado con» para lo descriptivo. «Efecto» y «reduce» solo con una estrategia de identificación nombrada junto al estimado. Es la diferencia entre un laboratorio y una nota de opinión con gráficas.

5. Las personas se cuentan, nunca se hacen espectáculo. Detrás de cada registro del RNPDNO hay una persona y una familia. El tratamiento sobrio no es frialdad: es la forma de respeto que puede ofrecer un laboratorio de datos.

Cómo leer esta guía

La guía es prosa; la norma es rules/rules.yaml. Cada capítulo incluye sus reglas desde ahí en vez de reescribirlas, de modo que no puedan separarse.

Cuando veas un recuadro con un identificador —UMB-COL-004— estás leyendo el texto normativo, generado. Cuando leas párrafos como éste, estás leyendo explicación, que orienta pero no obliga.

La cadena normativa

rules/rules.yaml  +  tokens/src/*.tokens.json      ← aquí se decide
        ↓ build
tokens/build/*  ·  rules/rules.json                ← generado, versionado, nunca a mano
        ↓ consumido por
guide/*.md  ·  site/  ·  packages/  ·  skills/  ·  tools/umbral-lint

Tres consecuencias que gobiernan todo lo demás:

Por qué existe este repositorio

La versión 1.0 de la marca era buena y estaba bien aplicada. La auditoría de julio de 2026 encontró que aun así el 44% del texto del sitio principal no alcanzaba el contraste mínimo de accesibilidad — y que casi ningún defecto era un error de aplicación. Eran instrucciones que se siguieron al pie de la letra:

• El documento de ingeniería pedía auto-hospedar las fuentes en prosa y entregaba un enlace a Google Fonts en el bloque de código de la misma sección. El sitio copió el bloque de código.
• El brand book y el documento de ingeniería no coincidían sobre el tercer color de serie, y la versión que ganó en las herramientas de Python era la que fallaba contraste.
• El documento afirmaba que ambos modos cumplían WCAG AA. Cuatro pares no lo cumplían, y nadie tenía forma de comprobarlo.

De ahí la arquitectura: un valor se enuncia en un solo lugar, y lo que no se puede comprobar automáticamente se comprueba en una lista corta que cabe en una página.

Índice de reglas

69 reglas · 58 error · 10 advertencia · 1 guía.

Marca

Color

Tipografía

Layout

Gráficas

Voz

Números y unidades

Datos y procedencia

Accesibilidad

Método

Proceso