Triagem de problemas de tradução no Jira

Transforme feedback com etiquetas no Jira em sugestões para engines, revise cada alteração e escolha quais conteúdos conectados traduzir novamente.

Um problema de tradução costuma revelar um sintoma visível: um termo de produto incorreto, um botão em inglês em uma tela traduzida ou um texto que já não cabe no espaço disponível. Conecte o Jira para levar esse feedback à Fila, onde você pode revisar propostas de alteração no glossário, nas regras e na voz da marca dos engines que escolher.

No menu de navegação do Studio 2.5, acesse Studio 2.5 → Integrações em vez de Configurações → Integrações. Os links de conexão e configuração existentes continuam funcionando.

Escolha Aplicar ou Descartar para cada sugestão. Depois de aplicar as alterações, use a aba Traduzir novamente do chamado para decidir quais conteúdos conectados gerar novamente.

Conecte o Jira e descreva o problema #

A integração é compatível com o Jira Cloud, incluindo o Jira Service Management Cloud, e requer o plano Enterprise. Consulte os preços para conferir a disponibilidade atual.

  1. Abra Fila → Configurações na organização desejada do Lingo.dev.
  2. Em Fontes de triagem, selecione Conectar e autorize o site do Jira via OAuth da Atlassian. As conexões de conta são gerenciadas em Configurações → Integrações.
  3. De volta às configurações da Fila, selecione Escolher engines para o site. Escolha os engines de localização que os problemas desse site poderão alterar e selecione Salvar.

O site precisa ter pelo menos um engine selecionado para que seus problemas gerem sugestões. Ao salvar a seleção, os problemas já abertos com a etiqueta lingo também são processados. Um site só pode pertencer a uma organização conectada por vez. Os comentários no Jira usam a identidade da conta que autorizou a conexão; use uma conta compartilhada adequada se a equipe precisar compartilhar a autoria.

Conectar o site, escolher seus engines e traduzir novamente exigem org:manage_integrations. Aplicar ou descartar uma sugestão exige org:suggestion:edit junto com acesso de edição ao engine correspondente, ou uma permissão explícita de acesso a esse engine para um membro da organização. Consulte Permissões de sugestões para saber como conceder acesso.

Inclua no problema informações suficientes para a investigação:

  • O idioma afetado, os textos exatos de origem e de destino exibido, além da localização ou revisão de ambos.
  • O resultado esperado e o problema observado. Se o problema for de apresentação, inclua uma captura de tela ou informe a restrição de espaço.
  • O aplicativo ou engine de localização envolvido, além de qualquer decisão terminológica já aprovada.

Por exemplo: “Na finalização da compra em es-MX, o botão de origem diz ‘Fazer pedido’, mas o texto de destino exibido continua em inglês na revisão X.” O relato identifica uma ocorrência não traduzida sem presumir que uma entrada no glossário seja a solução.

Adicione a etiqueta lingo, sem distinção entre maiúsculas e minúsculas, a um problema aberto. O Lingo.dev lê o resumo, a descrição e os comentários e propõe alterações para os engines selecionados do site. Abra a Fila, use o filtro Tipo para exibir itens de Triagem e selecione o chamado para revisar suas sugestões.

Atualizações em um problema com a etiqueta também podem levá-lo à Fila. Um chamado que já está aberto mantém sua rodada atual de sugestões.

Verifique se a correção proposta resolve o problema #

Leia a ocorrência relatada antes de aplicar uma sugestão. Alguns problemas exigem orientações de tradução compartilhadas; outros, uma alteração no aplicativo ou na entrega.

Problema relatadoO que verificar
Um termo de produto incorreto em um idiomaO termo esperado, o par de idiomas e o engine de localização cujo glossário deve ser alterado.
Um formato de data inesperado em coreanoSe o valor é um texto traduzido ou é gerado por um formatador do aplicativo.
O texto em alemão ultrapassa os limites de um controle de navegaçãoSe uma redação mais concisa preserva o significado dentro da largura disponível ou se o componente precisa de um ajuste de layout.
Vários idiomas exibem o texto de origemSe as traduções foram geradas, carregadas e selecionadas para cada idioma.
As requisições à API retornam 429Se o problema realmente está na redação da tradução, e não em um limite da API.

Se houver um catálogo ausente, um problema no formatador de datas ou um defeito de layout, atribua a correção ao responsável pelo aplicativo. Altere o glossário, uma regra ou a voz da marca quando isso atender à necessidade de redação descrita no relato.

Aplique ou descarte cada sugestão #

Abra a aba Sugestões do chamado. Para cada proposta, confira o engine de localização, o idioma, a explicação e o recurso de destino. As sugestões podem:

  • Adicionar ou atualizar um termo do glossário.
  • Adicionar ou atualizar uma regra de tradução.
  • Adicionar ou atualizar uma variação de voz da marca.

Escolha Aplicar para salvar a alteração imediatamente ou Descartar para manter as orientações como estão. Verifique se há orientações duplicadas ou conflitantes e examine os outros engines que compartilham o recurso de destino. Depois de aplicar a alteração, abra o termo, a regra ou a variação de voz da marca que você salvou para conferir.

Quando a geração terminar e todas as sugestões do chamado tiverem sido aplicadas ou descartadas, o Lingo.dev publicará um comentário no Jira com um resumo dos resultados e um link para a Fila. Se nenhum engine propuser uma alteração, o resumo informará isso. Depois de conferir o resultado, feche o problema no Jira seguindo o processo habitual da equipe.

Decida se deseja atualizar as traduções existentes #

Depois de aplicar uma sugestão, abra a aba Traduzir novamente do chamado. Ela lista as integrações afetadas do GitHub, Zendesk e Payload CMS e os idiomas de destino aos quais as alterações se aplicam.

Selecione as integrações que deseja atualizar, confira os idiomas listados e escolha Traduzir novamente. Isso gera novamente todo o escopo configurado de cada integração selecionada nesses idiomas. Essa ação pode substituir edições humanas aceitas e gera o consumo normal de tradução.

Acompanhe cada execução e confira o resultado no destino: as diferenças no repositório ou a solicitação de pull no GitHub, ou o conteúdo traduzido e o estado de publicação no Zendesk ou no Payload. Revise e faça a mesclagem ou a publicação seguindo o processo habitual. Você pode deixar a nova tradução para depois; as orientações aplicadas continuam salvas.

Retome ou encerre a triagem #

Remover a etiqueta lingo, fechar ou excluir a issue encerra o ticket correspondente na Fila e descarta as sugestões pendentes que não sejam referenciadas por nenhum outro ticket aberto. As alterações aplicadas permanecem salvas. Reabrir uma issue que ainda tenha a etiqueta ou adicionar a etiqueta novamente a uma issue aberta após o encerramento do ticket inicia uma nova rodada de sugestões, preservando o histórico anterior.

Se um chamado esperado não aparecer, verifique se o problema está aberto, tem a etiqueta lingo e pertence a um site conectado com engines selecionados em Fila → Configurações. Confira o plano da organização e o estado da conexão. Se um chamado continuar em processamento depois que o acesso da conexão for restaurado, compartilhe o link dele com o suporte do Lingo.dev.

Gerencie a autorização da conta e a desconexão em Configurações → Integrações. Para impedir que novos problemas gerem sugestões sem desfazer a conexão, remova todos os engines da seleção em Fila → Configurações e salve. Encerre os chamados existentes separadamente no Jira.

Os webhooks do Jira são renovados periodicamente. Se as atualizações pararem de chegar, verifique a autorização do site e a integridade da conexão; reconecte quando for necessário restaurar o acesso. Revogue a autorização OAuth separadamente quando o acesso ao provedor precisar ser encerrado. Os comentários existentes, as orientações aplicadas e as traduções concluídas são mantidos.