Revisão de tradução, um idioma de cada vez
translation-check prova que cada chave existe com os placeholders corretos. Esta skill lê as palavras.
1. Escopo e contexto
- Quais textos: as chaves que uma alteração adicionou ou editou (diff dos arquivos de localização em relação ao branch base), ou um namespace/arquivo inteiro, se solicitado. Obtenha o valor de referência e o valor de cada idioma lado a lado.
- Onde aparecem: encontre o uso de cada chave no código (
git grep "<key>"). É um botão, um título, um e-mail, um erro, uma dica de ferramenta? Quanto espaço ele tem? Está em uma frase com outras chaves ou recebe um{{count}}, um nome, uma data? - Regras do projeto:
AGENTS.mde.claude/translations.json, para palavras a evitar, nomes de produtos e planos que permanecem sem tradução, formalidade e quem é o leitor (cliente, revendedor, administrador). - Glossário existente: como os mesmos termos já estão traduzidos em outros lugares nos arquivos daquele idioma.
git grepum termo na pasta de localização. Consistência supera sua preferência pessoal.
2. Revisar cada idioma separadamente
Para cada idioma, verifique cada texto quanto a:
- Significado: diz o mesmo que a referência. Nada adicionado, nada removido, sem falsos cognatos. Os placeholders são usados no papel gramatical correto.
- Natural: soa como uma redação própria do produto naquele idioma, e não uma tradução palavra por palavra do inglês. Cuidado com a ordem das palavras, artigos e capitalização (substantivos alemães capitalizados; nenhum Title Case em inglês em outros idiomas).
- Termos: a mesma coisa tem o mesmo nome em todos os lugares (relatório, pedido, crédito, VIN, nomes de planos) e corresponde ao glossário da etapa 1.
- Formalidade: um único registro em todo o produto, ex. Sie ou du em alemão, ви em ucraniano, vous em francês, Vy em tcheco, Pan/Pani ou formas neutras em polonês. Não os misture.
- Gramática com variáveis: formas plurais corretas para contagens reais (1, 2, 5, 21, 22, 25 em ucraniano, polonês, tcheco); caso após preposições; concordância de gênero quando um placeholder é um substantivo.
- Comprimento: botões, abas e emblemas devem permanecer aproximadamente tão curtos quanto a referência. Sinalize qualquer coisa cerca de 40% mais longa em um espaço apertado.
- Convenções locais: unidades (км, кВт, к.с. em ucraniano/búlgaro), vírgula decimal, ordem da data, posição da moeda, aspas („…" em alemão, « … » em francês, «…» em ucraniano).
- Regras do projeto: palavras proibidas, ortografia da marca, nomes de planos.
3. Relatório
Agrupe por idioma e apresente cada descoberta com a chave, o texto atual, o problema e um texto sugerido:
uk — 2 descobertas
- reportPage:upgrade.cta — "Оновити до Complete звіту" — ordem das palavras parece inglesa; Complete é um nome de plano → "Перейти на звіт Complete"
- ...
de — nenhuma descoberta
- Diga quais idiomas você pode avaliar com confiança. Para aqueles que não puder, diga isso em vez de adivinhar e sugira uma verificação nativa.
- Se solicitado a corrigir: aplique as sugestões nos arquivos de localização, execute
i18n:translation-checknovamente e faça commit com a alteração. - Em uma revisão de PR, publique estas como Nits, a menos que o significado esteja errado ou uma palavra proibida apareça: nesse caso, é Importante.