Ir al contenido

Erratas de las fuentes publicadas

Implementar una norma en sala limpia significa volver a deducir cada fórmula, constante y ejemplo resuelto a partir del documento fuente y no del código de otra persona. Hecho sobre cientos de documentos, ese proceso encuentra defectos en las propias fuentes: un ejemplo resuelto que contradice su articulado, una constante a la que la composición tipográfica le comió un dígito, una referencia cruzada que apunta a la ecuación equivocada.

Este es el registro de esos hallazgos. Cubre todos los tipos de fuente publicada de los que parte la biblioteca: normas (ISO, IEC, EN), documentos de guía e informes técnicos (EASA, ECAC, NRL), libros y artículos de revista. Las fuentes no normativas quedan marcadas como tales en su entrada.

Cada entrada nombra la edición impresa y el punto exacto, cita lo que dice el documento, muestra por qué no puede ser correcto, aporta la evidencia independiente y declara qué lectura implementa la biblioteca. Cuando esa lectura cambia algún número que da la biblioteca, la entrada nombra la comprobación o el test de regresión que lo fija; cuando el defecto es una etiqueta, una referencia cruzada o una tabla que la biblioteca nunca lee, la entrada deja constancia de que no hizo falta ningún cambio. Un defecto listado aquí nunca es un defecto del método: en todos los casos la lectura pretendida se ha podido establecer a partir del propio documento o de la física.

Léelo junto al informe de conformidad, que muestra los números que calcula la biblioteca; el registro explica el puñado de sitios donde lo que está mal es el valor esperado impreso.

Cada entrada vive en la página del documento del que trata, una página por familia de documentos: todas las partes y ediciones de la ISO 3743 en una página, un libro en una página con el nombre de sus autores. Todas las entradas se listan abajo bajo su documento. Un enlace a una entrada escrito como /es/reference/errata/#entrada, de antes de que el registro se dividiera, sigue llevando a ella.

El registro vive en docs/ERRATA.md con su edición española en docs/ERRATA.es.md, y las entradas de esta última se trasplantan a estas páginas en tiempo de compilación con make site-reports, que además exige que las dos ediciones lleven las mismas entradas en el mismo orden, así que ninguna pareja puede discrepar.

Leyenda de estados: sin notificar (registrado solo aquí) / notificado (comunicado al organismo emisor, con fecha y referencia).

Una afirmación que dependa de los caracteres exactos de una fórmula, constante, coeficiente, símbolo, desigualdad o celda de tabla se verifica contra la página tal como está impresa, y su punto de Evidencia cita esa página por índice de página del PDF y folio impreso. El texto extraído puede localizar una página; nunca se cita como «el impreso», porque las capas de texto de los PDF borran glifos en silencio (la mayoría de las fuentes citadas aquí no emiten ningún √, así que f_T/√2 se extrae como f_T/2). El desplazamiento de páginas de cada documento se establece empíricamente, porque difiere entre documentos y deriva entre capítulos de un mismo libro. Las entradas que descansan en otra cosa, un recálculo o la comparación de dos frases, lo dicen en un aviso inicial o figuran en la lista de excepciones de scripts/check_errata_evidence.py, que es la comprobación que hace cumplir la regla; véase CONTRIBUTING.md.

Una página por serie, que reúne sus partes, sus ediciones y sus adopciones nacionales.

DIN 4150 16 entradas

Una página por documento, con el nombre de sus autores o de quien lo emite.

Propiedades de las fuentes que parecen erratas y no lo son, registradas para que nadie corrija la biblioteca para ajustarse a ellas.