Colete traduções para medição
Escolha uma fonte compatível e preserve o texto, as revisões e o contexto necessários para a medição.
A medição pode começar pelas traduções que sua equipe já produz. Mantenha o repositório ou o sistema de gerenciamento de traduções como o local responsável por manter o texto aceito e escolha como disponibilizá-lo para verificação.
O que importa é ter uma versão identificável. Se uma mensagem mudar após a avaliação, a resposta anterior continuará se referindo à redação anterior. Manter as revisões de origem e destino juntas permite que a equipe consulte as evidências, em vez de reconstruí-las a partir do conteúdo mais recente.
Escolha a fonte para seu workflow #
| Ponto de partida | Como medir |
|---|---|
| Atividade no Crowdin | Conecte o Crowdin, configure uma medição de eventos e confira o evento gerado no Radar e a respectiva resposta. É necessário ter acesso ao Radar para visualizar suas telas. |
| Commits do GitHub | Conecte o GitHub App e configure os caminhos de origem e destino. Alterações em chaves de localização compatíveis na branch padrão se tornam eventos. |
| Central de Ajuda do Zendesk | Conecte o Zendesk. Alterações em artigos publicados se tornam eventos de origem ou de tradução nos respectivos idiomas. |
| Arquivos de tradução locais | Use lingo score com um avaliador e um modelo configurados. Os resultados são salvos localmente, fora do histórico de eventos do Radar. |
| Traduções do Lingo.dev | Cada localização concluída já é um evento. Revisar traduções do Lingo.dev explica como selecionar engines, idiomas e uma amostra. |
Para usar outra fonte, entre em contato com o Lingo.dev para combinar a coleta de eventos antes de automatizar a entrega.
Colete atividades do GitHub e do Zendesk #
No GitHub, instale o GitHub App no repositório desejado e conecte-o à organização do Lingo.dev. Faça commit de .lingo/config.json com o idioma de origem, os idiomas de destino e os padrões de arquivos de origem. Esses caminhos identificam quais alterações correspondem ao texto de origem e quais correspondem às traduções. Confira um evento depois que um commit na branch padrão alterar uma chave de localização configurada; um único commit pode gerar eventos para várias chaves e idiomas.
A coleta do GitHub lê arquivos JSON, JSONC, YAML, YAML com chave raiz, recursos do Android, arquivos .strings da Apple, Flutter ARB, PHP e TypeScript. Alterações no repositório explica como as alterações se tornam eventos.
No Zendesk, autorize a conexão com a Central de Ajuda e habilite seus idiomas. O Radar registra a atividade dos artigos publicados por idioma. Abra o evento e compare a identificação do artigo, o idioma e o texto com os dados no Zendesk. A coleta de atividades, por si só, não aciona uma sincronização de tradução nem publica um novo artigo de destino.
As duas conexões mantêm as traduções aceitas no sistema original. A medição examina os eventos registrados, sem assumir o papel da etapa de publicação.
Importe o histórico do provedor antes de medi-lo #
Escolha o histórico do provedor de que você precisa:
- GitHub: importa até os 5.000 commits mais recentes da branch padrão do repositório. Cada commit é lido com
.lingo/config.jsonsalvo naquela revisão. Commits anteriores à existência dessa configuração não geram eventos. - Zendesk: importa as versões publicadas atuais dos artigos, seções e categorias existentes em cada idioma, com a data da última atualização. Revisões anteriores e rascunhos ficam fora dessa coleta.
Novas conexões do GitHub e do Zendesk iniciam a importação do histórico automaticamente. Acompanhe o progresso na aba Configurações da conexão. Para iniciar uma importação ou tentar novamente mais tarde:
- No Studio, selecione o repositório ou a Central de Ajuda em Conectado e abra a aba Configurações.
- Em Histórico de commits, para o GitHub, ou Histórico da Central de Ajuda, para o Zendesk, selecione Importar histórico.
- Acompanhe o progresso da importação, que contabiliza os itens do provedor na fila de coleta.
- Aguarde até que os eventos que você pretende medir apareçam em Radar → Registros e confira as datas, os idiomas e o texto.
Para medições executadas sobre eventos de provedores, a aba Preenchimento retroativo também oferece a opção Importar eventos, com os repositórios do GitHub e as Centrais de Ajuda do Zendesk conectados. O histórico é importado sem executar medições. Quando os eventos desejados estiverem visíveis, habilite a medição e inicie uma avaliação histórica para o período correspondente.
Se mais eventos importados aparecerem após o preenchimento retroativo, execute-o novamente com Somente eventos ainda não medidos habilitado. Se a importação falhar, confira o progresso e tente novamente na mesma aba Configurações. Verifique o preenchimento retroativo e os resultados da medição separadamente da importação.
Preserve a comparação #
Mantenha juntos o ID do sistema de origem, o ID do conteúdo, o idioma de destino e a revisão de destino. Para verificar o significado, adicione a revisão de origem correspondente. Para medir uma edição, guarde o rascunho usado para produzir o texto de destino editado.
Por exemplo, no seu próprio registro de acompanhamento, a combinação de delivery.promise, idioma fr e revisão 42 identifica uma entrada específica do catálogo. A revisão 43 pode mudar o que é prometido.
Registre a origem da tradução quando o workflow fornecer essa informação: uma pessoa, um modelo, um provedor de tradução automática ou a reutilização de uma memória de tradução. Se a origem for desconhecida, mantenha-a assim. Um usuário do provedor que aprovou uma tradução não é necessariamente a pessoa ou o modelo que a escreveu.
Forneça evidências para a pergunta escolhida #
O critério determina o que coletar. Uma verificação ortográfica pode examinar apenas o texto de destino. Uma verificação de significado precisa dos textos de origem e destino correspondentes, com contexto para resolver ambiguidades. Uma verificação de terminologia precisa do termo aplicável e dos limites de uso desse termo. Uma verificação de marcadores de posição precisa das regras esperadas para esses marcadores, enquanto a distância de edição exige o par efetivo de rascunho e texto de destino.
Se uma tradução não tiver a revisão de origem, mantenha-a entre os casos não avaliados na verificação de significado e obtenha o texto de origem antes de avaliá-la.
Verifique um evento coletado #
- Configure a medição selecionada antes de gerar atividades de teste na fonte conectada.
- Encontre o evento correspondente. Compare o idioma, o texto, a procedência e o rascunho disponível com seu próprio registro.
- Abra a resposta da medição e leia o critério ao lado do texto. Verifique se a medição retornou uma resposta, retornou N/A ou não foi concluída.
- Mantenha os identificadores do evento e da medição junto às revisões avaliadas. Faça as correções aceitas no sistema responsável pelo texto.
Para a pontuação local, confira o resultado salvo junto aos arquivos de entrada e à configuração do avaliador; esse processo não cria um evento no Radar.
Para um workflow recorrente, mantenha um registro do que foi selecionado, coletado e medido. Meça traduções do seu pipeline aborda a coleta e a recuperação, incluindo novas tentativas e revisões alteradas.