gobernanza

Cómo se traduce leji.org

Traducción asistida por agentes de IA. Ante cualquier diferencia, prevalece la página en inglés. Si encuentra algún problema en el texto, abra un issue o envíe un pull request.

leji.org se escribe en inglés y se traduce idioma por idioma. Esta página deja constancia de qué texto prevalece cuando las dos versiones difieren, cómo se hace una traducción, qué referencias sigue su terminología y cómo informar de un error.

El inglés es el texto que prevalece

Toda página se escribe primero en inglés. Una página traducida es la traducción de esa página y lo indica bajo su título; donde ambas difieren, prevalece el texto en inglés. Las traducciones de la especificación son informativas: el texto normativo es el inglés de la línea 1.0, congelada, y cada página traducida de la especificación lleva un aviso que así lo dice.

Cómo se hace una traducción

Las páginas se redactan con un flujo de trabajo asistido por agentes y luego se aprueban página por página antes de publicarse. Dos motores revisores independientes, ninguno de los cuales redactó la página, comprueban la fidelidad al inglés, la terminología frente al glosario del idioma y la fluidez, y la página se publica solo cuando ambos coinciden.

Terminología

Cada idioma mantiene un glosario de los términos que usa Leji. Cuando un término ya tiene una traducción asentada en la traducción humana de un proyecto de código abierto conocido, el glosario la sigue o registra una excepción razonada. Esas referencias son una ayuda, nunca una fuente. La lista siguiente se mantiene al día a medida que aparecen y desaparecen las traducciones de esos proyectos.

Chino simplificado

• MDN Web Docs (zh-CN)
• Documentación de Kubernetes (zh-cn)
• Pro Git (zh)
• GitHub Docs (zh)
• Documentación de Python 3 (zh-cn)
• Vue.js (zh)
• Vite (zh)
• React (zh-hans)
• TypeScript (zh)
• Keep a Changelog (zh-CN)
• Semantic Versioning (zh-CN)
• Hugging Face Agents Course (zh-CN)

Japonés

• Pro Git (ja)
• GitHub Docs (ja)
• Documentación y glosario de Kubernetes (ja)
• MDN Web Docs (ja)
• React (ja)
• Vue (ja)
• Documentación de Python (ja)
• Python Packaging User Guide (ja)
• WCAG 2.1 (ja, WAIC)
• Contenido común de las especificaciones del W3C (ja)
• W3C (ja)
• Keep a Changelog (ja)
• Semantic Versioning (ja)
• Vite (ja)
• Rails Guides (ja)
• OpenStack Security Guide (ja)

Portugués de Brasil

• Pro Git (pt-br)
• GitHub Docs (pt)
• Documentación de Kubernetes (pt-br)
• Documentación de Python (pt-br)
• MDN Web Docs (pt-BR)
• Traducción autorizada de WCAG 2.0 del W3C (pt-br)
• Documentación de Django (pt-br)
• Documentación de React (pt-br)
• Documentación de Astro (pt-br)
• Keep a Changelog (pt-BR)
• Sitio de TypeScript (pt)
• Documentación de Vue (pt)

Español

• Pro Git (es)
• Localización al español de Git (po/es.po)
• Documentación y glosario de Kubernetes (es)
• MDN Web Docs (es)
• Documentación de Python (es)
• Documentación de React (es)
• Keep a Changelog (es)
• Semantic Versioning (es)
• Conventional Commits (es)
• Open Source Guides (es)
• GitHub Docs (es)
• Documentación de Astro (es)

Vietnamita

• Localización al vietnamita de Git (po/vi.po)
• Documentación y glosario de Kubernetes (vi)
• Semantic Versioning 2.0.0 (vi)
• Documentación de Vue.js (vi, Vue 2)
• The Twelve-Factor App (vi)
• Contributor Covenant 2.1 (vi)
• Localización de GNOME GTK (po/vi.po)
• Borradores de normas nacionales vietnamitas (vocabulario de documentos de normalización)
• Wikipedia en vietnamita (secundaria)

Mantenerse al día

Cada página traducida registra qué revisión de su fuente en inglés sigue. Una comprobación en cada compilación la hace fallar si alguna traducción se ha quedado atrás respecto de su fuente, de modo que una traducción publicada nunca es más antigua que el inglés que traduce. La revisión se registra, no se muestra.

Cómo informar de un error

Cada página traducida lleva dos enlaces bajo su título: uno abre un issue con el idioma y la página ya rellenados, el otro abre el archivo fuente de la propia página para un pull request. La vista de la especificación en una sola página es la excepción: se compone de varios documentos y no de uno solo, así que su enlace de issue está en el aviso de la parte superior y hay un enlace de edición junto a cada encabezado de documento. Una corrección se revisa como cualquier otro cambio y llega con la siguiente publicación.

Qué no se traduce

Los nombres de comandos, las opciones, las rutas, las claves JSON y los ejemplos de código se mantienen en inglés; los comentarios dentro de un ejemplo de código sí se traducen. Los propios archivos de JSON Schema y las rutas de markdown en bruto se mantienen en inglés.