Traduções
Como o DispatchAtlas localiza sua documentação: o coorte de locales, a cobertura atual, o pipeline de semente-de-máquina mais revisão-humana, e como contribuir uma tradução.
O DispatchAtlas serve sua documentação em um coorte de doze locales. O inglês é a fonte; cada outro locale é um alvo de tradução. Esta página declara o que está traduzido hoje, a disciplina que governa a qualidade de tradução, e os passos para contribuir uma tradução.
Coorte de locales
O site registra doze locales — inglês na raiz do site e onze alvos de tradução com prefixo:
| Locale | Código | Direção |
|---|---|---|
| Inglês (fonte) | en | esquerda-para-direita |
| Mandarim (simplificado) | zh-cn | esquerda-para-direita |
| Espanhol | es | esquerda-para-direita |
| Português (Brasil) | pt-br | esquerda-para-direita |
| Francês | fr | esquerda-para-direita |
| Alemão | de | esquerda-para-direita |
| Japonês | ja | esquerda-para-direita |
| Coreano | ko | esquerda-para-direita |
| Russo | ru | esquerda-para-direita |
| Indonésio | id | esquerda-para-direita |
| Árabe | ar | direita-para-esquerda |
| Hindi | hi | esquerda-para-direita |
Cada página declara seu lang, o árabe adicionalmente renderiza da direita-para-esquerda,
e um conjunto hreflang simétrico mais um x-default apontando para a página em inglês
liga o coorte para os motores de busca. Um locale que ainda não traduziu uma dada página
omite a entrada hreflang dessa página em vez de apontá-la para o inglês, de modo que a
ausência é reportada com precisão.
Cobertura atual
O cromo da interface — navegação, controles, busca, e rodapé — está traduzido através dos doze locales. As páginas de documentação são traduzidas de forma incremental; uma página sem tradução no locale solicitado renderiza a fonte em inglês como fallback, de modo que nenhuma rota é jamais quebrada. A cobertura cresce página-por-página sob o pipeline de revisão abaixo; o alternador de idioma sempre alcança cada página ao menos em sua forma em inglês.
O pipeline de semente-de-máquina mais revisão-humana
A qualidade de tradução é um critério de lançamento, não um pensamento tardio. Duas etapas governam cada página traduzida:
- Semente de máquina. Uma página é primeiro rascunhada por tradução automática contra o glossário por-locale, que fixa o vocabulário de domínio (escalonamento, dispatch, benchmark, solver, objetivo, restrição) a um termo consistente por locale.
- Revisão humana. Um revisor nativo-fluente corrige a semente para fluência, terminologia, e tom antes de ela ser enviada. A cópia com semente-de-máquina nunca é publicada como texto final não revisado.
Uma página é pronta-para-lançamento em um locale apenas depois de um revisor a ter atestado. Até então o fallback em inglês permanece, que é preciso e completo em vez de parcialmente-traduzido.
Contribuir uma tradução
- Escolha uma página sob
site/content/docs/en/e o locale alvo. - Crie o caminho espelho sob
site/content/docs/<locale>/com o mesmo slug relativo e as mesmas chaves de frontmatter (title,description). - Traduza o corpo, honrando o glossário do locale para que os termos de domínio permaneçam consistentes com o resto desse locale.
- Mantenha cada bloco de código, comando, identificador, alvo de link, e referência de figura idênticos à fonte — apenas a prosa em linguagem natural é traduzida.
- Abra uma contribuição para revisão nativo-fluente. Uma vez atestada, a página é
enviada nesse locale e sua entrada
hreflangé adicionada ao coorte.
Veja o Guia de contribuição para o fluxo de trabalho do repositório e o processo de revisão que se aplica a cada mudança.