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.
- Abra Fila → Configurações na organização desejada do Lingo.dev.
- 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.
- 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 relatado | O que verificar |
|---|---|
| Um termo de produto incorreto em um idioma | O termo esperado, o par de idiomas e o engine de localização cujo glossário deve ser alterado. |
| Um formato de data inesperado em coreano | Se 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ção | Se 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 origem | Se as traduções foram geradas, carregadas e selecionadas para cada idioma. |
| As requisições à API retornam 429 | Se 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.