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
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.
npm run lint-glossaryreporta 748 problemas en 190 archivos. Son dos cosasdistintas 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.mtsconstruye su matcher desde unenum con las claves en inglés, así que
NOTA:no coincide y el aviso sale comopárrafo plano en vez de caja de color.
NOTA:→NOTE:ÚTIL:→HELPFUL:IMPORTANTE:→IMPORTANT:CONSEJO:→TIP:RESUMEN:→SUMMARY:CRÍTICO:→CRITICAL:PREGUNTA:→QUESTION:Hay que decidir entre dos caminos, y no son equivalentes:
A. Revertir los prefijos a inglés. Un
sedsobre 174 archivos. Los avisosvuelven 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 laclave 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()entools/lib/common.mjsya recorretools/git-patches/*.patch, solo que esacarpeta no existe todavía.
2. Terminología — 323 en 48 archivos
librería(s)→biblioteca(s)sistema de construcción→sistema de compilaciónanimaciones de Angular→animaciones en Angularseñal(es)→signal(s)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
--fixen el linter, quehoy no existe. Antes de dárselo hay que revisar las reglas una por una: la de
señalya se corrigió porque marcaba «señalar» y «señalización», y conreescritura automática los habría convertido en «signalar» y «signalización».
Criterios de aceptación
npm run lint-glossaryno reporta ningún problemanpm run buildrenderiza los avisos como cajas de color, no como párrafosPor 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.