Pular para o conteúdo
DispatchAtlas
Buscar

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:

LocaleCódigoDireção
Inglês (fonte)enesquerda-para-direita
Mandarim (simplificado)zh-cnesquerda-para-direita
Espanholesesquerda-para-direita
Português (Brasil)pt-bresquerda-para-direita
Francêsfresquerda-para-direita
Alemãodeesquerda-para-direita
Japonêsjaesquerda-para-direita
Coreanokoesquerda-para-direita
Russoruesquerda-para-direita
Indonésioidesquerda-para-direita
Árabeardireita-para-esquerda
Hindihiesquerda-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:

  1. 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.
  2. 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

  1. Escolha uma página sob site/content/docs/en/ e o locale alvo.
  2. Crie o caminho espelho sob site/content/docs/<locale>/ com o mesmo slug relativo e as mesmas chaves de frontmatter (title, description).
  3. Traduza o corpo, honrando o glossário do locale para que os termos de domínio permaneçam consistentes com o resto desse locale.
  4. 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.
  5. 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.