better-i18n Garantía de Calidad en Traducciones: Verificaciones Automatizadas a Escala

Mantener sus traducciones consistentes

La calidad de las traducciones no consiste solo en acertar con las palabras -- se trata de asegurarse de que cada key esté contemplada, que los keys no utilizados se limpien y que su terminología sea consistente en todos los idiomas. better-i18n ofrece varias herramientas que trabajan juntas para mantener la calidad de las traducciones en su proyecto.

CLI Scan: Detectar strings hardcodeados

La primera línea de defensa es el comando scan. Analiza su codebase mediante análisis AST para encontrar strings que deberían traducirse pero no están envueltos en funciones de traducción.

better-i18n scan --dir ./src

El scanner detecta:

• Texto JSX hardcodeado (<h1>Hello</h1>)
• Atributos JSX hardcodeados (<img alt="Logo" />)
• Strings de toast y notificaciones
• Expresiones ternarias dependientes de locale
• Variables de string que contienen texto orientado al usuario

Es lo suficientemente inteligente para ignorar clases CSS, URLs, entidades HTML y constantes técnicas -- de modo que los resultados se centran en las brechas de traducción reales, no en falsos positivos.

Use --ci para integrarlo en su pipeline de build y bloquear los PRs que introduzcan nuevos strings hardcodeados:

npx @better-i18n/cli scan --ci

CLI Sync: Encontrar keys faltantes y no utilizados

El comando sync compara el uso de keys de traducción en su codebase con lo que existe en la nube de better-i18n:

better-i18n sync

Genera un informe claro que muestra:

• Falta en Remote: Keys que su código usa pero que aún no se han subido a better-i18n
• No utilizado en el Código: Keys en better-i18n que ya no se referencian en su código fuente

Esto es muy valioso tras refactorizaciones -- puede ver inmediatamente qué keys quedaron huérfanos y limpiarlos, y qué nuevos keys necesitan traducciones antes de hacer el deploy.

El flag --summary le da un chequeo rápido de salud:

better-i18n sync --summary

Muestra porcentajes de cobertura (local-a-remote y remote-utilizado) para que sepa de un vistazo qué tan completas están sus traducciones.

Glosario: Consistencia terminológica

El Glosario impone terminología consistente en todas las traducciones. Cuando define términos de marca, nombres de productos o vocabulario específico del dominio en el glosario, las traducciones de IA respetan automáticamente esas definiciones.

Esto previene el problema habitual en el que el mismo concepto se traduce de manera diferente en su app -- "Workspace" en un lugar, "Área de trabajo" en otro y "Espacio de proyecto" en un tercero.

Visibilidad de cobertura en el dashboard

El dashboard de better-i18n muestra la cobertura de traducciones por idioma y por namespace. Puede ver de un vistazo:

• Qué idiomas están completamente traducidos
• Qué namespaces tienen brechas
• Cuántos keys existen en cada parte de su proyecto

Esto brinda a los product managers y líderes de ingeniería una vista clara del estado de localización sin necesidad de ejecutar comandos CLI.

Integración CI para Quality Gates

Combine scan y sync en su pipeline de CI para crear quality gates que eviten que los problemas de traducción lleguen a producción:

name: i18n Quality
on: [push, pull_request]
jobs:
  check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npx @better-i18n/cli scan --ci
      - run: |
          npx @better-i18n/cli sync --format json \
            | jq -e '.comparison.missingCount == 0' > /dev/null || exit 1

Para hooks de pre-commit, escanee solo los archivos staged para obtener feedback rápido:

npx @better-i18n/cli scan --staged --ci

Lo que aún no ofrecemos

Para ser claros sobre el alcance actual de las herramientas de calidad:

• Sin motor de QA inline -- no hay validación en tiempo real de placeholders, etiquetas HTML o ICU MessageFormat dentro del editor. La CLI detecta traducciones faltantes a nivel de código.
• Sin sistema de reglas personalizadas -- no puede definir reglas de validación personalizadas (como límites de longitud o caracteres prohibidos) hoy en día.
• Sin validación de placeholders -- el sistema no verifica que {name} en la fuente aparezca en la traducción.
• Sin contexto visual -- las verificaciones de calidad operan sobre datos key/value, no sobre capturas de pantalla de la UI renderizada.

Estas son áreas que estamos evaluando para el desarrollo futuro.

Primeros pasos

Instale la CLI y ejecute su primera verificación de calidad:

npm install -g @better-i18n/cli
better-i18n scan --dir ./src
better-i18n sync --summary

Configure términos de glosario en el dashboard para imponer consistencia en las traducciones de IA, e integre la CLI en su pipeline de CI para quality gates automatizadas.

Cree su cuenta para comenzar a gestionar la calidad de las traducciones en sus proyectos.