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 partidaComo medir
Atividade no CrowdinConecte 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 GitHubConecte 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 ZendeskConecte o Zendesk. Alterações em artigos publicados se tornam eventos de origem ou de tradução nos respectivos idiomas.
Arquivos de tradução locaisUse 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.devCada 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.json salvo 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:

  1. No Studio, selecione o repositório ou a Central de Ajuda em Conectado e abra a aba Configurações.
  2. Em Histórico de commits, para o GitHub, ou Histórico da Central de Ajuda, para o Zendesk, selecione Importar histórico.
  3. Acompanhe o progresso da importação, que contabiliza os itens do provedor na fila de coleta.
  4. 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 #

  1. Configure a medição selecionada antes de gerar atividades de teste na fonte conectada.
  2. Encontre o evento correspondente. Compare o idioma, o texto, a procedência e o rascunho disponível com seu próprio registro.
  3. 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.
  4. 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.