Repository navigation
Corregir terminología y avisos que no se renderizan #204
Description
npm run lint-glossary reporta 748 problemas en 190 archivos. Son dos cosas
distintas que conviene arreglar por separado.
1. Avisos que no se renderizan — 425 en 174 archivos
No es terminología: es markup roto. Los prefijos de alerta son claves del
tokenizer de adev, no prosa. docs-alert.mts construye su matcher desde un
enum con las claves en inglés, así que NOTA: no coincide y el aviso sale como
párrafo plano en vez de caja de color.
| Prefijo | Casos |
|---|---|
NOTA: → NOTE: |
128 |
ÚTIL: → HELPFUL: |
121 |
IMPORTANTE: → IMPORTANT: |
82 |
CONSEJO: → TIP: |
72 |
RESUMEN: → SUMMARY: |
16 |
CRÍTICO: → CRITICAL: |
5 |
PREGUNTA: → QUESTION: |
1 |
Hay que decidir entre dos caminos, y no son equivalentes:
A. Revertir los prefijos a inglés. Un sed sobre 174 archivos. Los avisos
vuelven a renderizarse, pero la etiqueta visible queda en inglés («NOTE» en una
página en español). Es lo que hace angular-ja: mantienen la clave inglesa y
traducen solo el cuerpo.
B. Parchear el tokenizer. Añadir un mapa de alias en
tools/git-patches/, de modo que acepte ambas formas, derive la clase CSS de la
clave inglesa —que es la que tiene estilos— y muestre la etiqueta en español.
Conserva la traducción visible, pero hay que mantener el parche en cada subida de
versión de Angular.
La infraestructura para B existe pero está vacía: applyPatches() en
tools/lib/common.mjs ya recorre tools/git-patches/*.patch, solo que esa
carpeta no existe todavía.
2. Terminología — 323 en 48 archivos
| Corrección | Casos |
|---|---|
librería(s) → biblioteca(s) |
272 |
sistema de construcción → sistema de compilación |
23 |
animaciones de Angular → animaciones en Angular |
13 |
señal(es) → signal(s) |
15 |
272 de 323 son la misma palabra. «Librería» es un falso amigo: en español
significa bookstore; la traducción de library es biblioteca.
Esta mitad es mecánica y se puede automatizar con un --fix en el linter, que
hoy no existe. Antes de dárselo hay que revisar las reglas una por una: la de
señal ya se corrigió porque marcaba «señalar» y «señalización», y con
reescritura automática los habría convertido en «signalar» y «signalización».
Criterios de aceptación
-
npm run lint-glossaryno reporta ningún problema -
npm run buildrenderiza los avisos como cajas de color, no como párrafos - El saneamiento de terminología va en un commit aparte del de los avisos
- Ninguna traducción cambia de sentido: son sustituciones léxicas, no reescrituras
Por qué conviene hacerlo pronto
Mientras el linter reporte 748 problemas no se puede hacer bloqueante en CI, y
sin eso nada impide que la deuda siga creciendo. Es el paso que desbloquea el
resto.
Activity