Skip to content

Corregir terminología y avisos que no se renderizan #204

Description

@oidacra

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ónsistema de compilación 23
animaciones de Angularanimaciones 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-glossary no reporta ningún problema
  • npm run build renderiza 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.

Metadata

Metadata

Assignees

Labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions