governança

Como o leji.org é traduzido

Tradução assistida por agentes de IA. Em caso de divergência, prevalece a página em inglês. Se você encontrar algum problema no texto, abra uma issue ou envie um pull request.

O leji.org é escrito em inglês e traduzido idioma por idioma. Esta página registra o que prevalece quando as duas versões divergem, como uma tradução é feita, quais referências sua terminologia segue e como relatar um erro.

O inglês é o texto que prevalece

Toda página é escrita primeiro em inglês. Uma página traduzida é a tradução dessa página e informa isso logo abaixo do título; onde as duas divergem, o texto em inglês prevalece. As traduções da especificação são informativas: o texto normativo é o inglês da linha 1.0, congelada, e cada página traduzida da especificação traz um aviso dizendo isso.

Como uma tradução é feita

As páginas são redigidas com um fluxo de trabalho assistido por agentes e depois aprovadas página por página antes de serem publicadas. Dois mecanismos revisores independentes, nenhum deles envolvido na redação da página, verificam a fidelidade ao inglês, a terminologia em relação ao glossário do idioma e a fluência; a página só é publicada quando os dois concordam.

Terminologia

Cada idioma mantém um glossário dos termos que o Leji usa. Quando um termo já tem uma tradução consagrada na tradução humana de um projeto de código aberto conhecido, o glossário a segue ou registra uma exceção fundamentada. Essas referências são apoio, nunca fonte. A lista abaixo é mantida atualizada conforme as traduções desses projetos surgem e desaparecem.

Chinês simplificado

• MDN Web Docs (zh-CN)
• Documentação do Kubernetes (zh-cn)
• Pro Git (zh)
• GitHub Docs (zh)
• Documentação do 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)
• Documentação e glossário do Kubernetes (ja)
• MDN Web Docs (ja)
• React (ja)
• Vue (ja)
• Documentação do Python (ja)
• Python Packaging User Guide (ja)
• WCAG 2.1 (ja, WAIC)
• Conteúdo comum das especificações do W3C (ja)
• W3C (ja)
• Keep a Changelog (ja)
• Semantic Versioning (ja)
• Vite (ja)
• Rails Guides (ja)
• OpenStack Security Guide (ja)

Português do Brasil

• Pro Git (pt-br)
• GitHub Docs (pt)
• Documentação do Kubernetes (pt-br)
• Documentação do Python (pt-br)
• MDN Web Docs (pt-BR)
• Tradução autorizada do WCAG 2.0 do W3C (pt-br)
• Documentação do Django (pt-br)
• Documentação do React (pt-br)
• Documentação do Astro (pt-br)
• Keep a Changelog (pt-BR)
• Site do TypeScript (pt)
• Documentação do Vue (pt)

Espanhol

• Pro Git (es)
• Localização do Git para o espanhol (po/es.po)
• Documentação e glossário do Kubernetes (es)
• MDN Web Docs (es)
• Documentação do Python (es)
• Documentação do React (es)
• Keep a Changelog (es)
• Semantic Versioning (es)
• Conventional Commits (es)
• Open Source Guides (es)
• GitHub Docs (es)
• Documentação do Astro (es)

Vietnamita

• Localização do Git para o vietnamita (po/vi.po)
• Documentação e glossário do Kubernetes (vi)
• Semantic Versioning 2.0.0 (vi)
• Documentação do Vue.js (vi, Vue 2)
• The Twelve-Factor App (vi)
• Contributor Covenant 2.1 (vi)
• Localização do GNOME GTK (po/vi.po)
• Projetos de normas nacionais vietnamitas (vocabulário de documentos normativos)
• Wikipédia em vietnamita (secundária)

Manter as traduções atualizadas

Cada página traduzida registra qual revisão da sua fonte em inglês ela segue. Em cada build, uma verificação o faz falhar se alguma tradução ficou para trás em relação à sua fonte, de modo que uma tradução publicada nunca é mais antiga que o inglês que ela traduz. A revisão é registrada, não exibida.

Como relatar um erro

Toda página traduzida traz dois links abaixo do título: um abre uma issue com o idioma e a página já preenchidos, o outro abre o arquivo-fonte da própria página para um pull request. A visualização da especificação em página única é a exceção: ela é composta a partir de vários documentos, e não de um só, por isso o link de issue fica no aviso do topo e um link de edição fica ao lado do título de cada documento. Uma correção passa pela mesma revisão de qualquer outra mudança e entra na próxima versão publicada.

O que não é traduzido

Nomes de comandos, flags, caminhos, chaves JSON e exemplos de código continuam em inglês; os comentários dentro de um exemplo de código são traduzidos. Os próprios arquivos de JSON Schema e as rotas de markdown bruto continuam em inglês.