Projete um pipeline de tradução

Transforme alterações no conteúdo de origem em traduções prontas para uso, com responsabilidades, revisão, entrega e recuperação bem definidas.

Um pipeline de tradução está completo quando uma alteração no conteúdo de origem se transforma em conteúdo pronto para uso no sistema que precisa dele. A geração é apenas uma parte. O workflow também precisa identificar a revisão correta, recuperar as traduções correspondentes, preservar o trabalho aceito e decidir o que pode ser publicado.

Comece projetando o pipeline para um tipo real de conteúdo: catálogos de repositório, artigos de CMS ou registros de aplicação. Cada tipo tem responsáveis e formas de entrega diferentes. Um workflow que trata os três da mesma maneira pode ocultar decisões que determinam se um resultado é seguro para uso.

Identifique quem responde por cada transição #

Um workflow para catálogos de repositório poderia adotar estas decisões:

TransiçãoDecisão
O conteúdo de origem se torna elegívelTraduza o conteúdo de origem já revisado, na revisão de um commit registrado, a partir de um gatilho confiável que exclua as traduções de destino geradas.
O trabalho começaUse o engine de localização, os idiomas, o formato e as versões de referência aceitas definidos explicitamente; obtenha aprovação para a execução quando necessário.
As traduções de destino se tornam aceitáveisOs revisores designados verificam as alterações necessárias, e os casos não resolvidos permanecem visíveis.
O resultado retornaOs recursos baixados e validados são incorporados a um pull request de tradução.
O conteúdo chega aos leitoresA versão da aplicação aceita a alteração e passa nas verificações dos seus recursos.
Um resultado precisa ser revertidoRestaure os recursos comprovadamente válidos e a configuração ou as versões de referência correspondentes.

Este é um exemplo de projeto de workflow, não o comportamento padrão do produto. Especifique o mecanismo que de fato garante o cumprimento de cada decisão. Uma política da equipe sem controle automático precisa de alguém designado para verificar seu cumprimento.

Escolha as ferramentas conforme suas responsabilidades #

Uma integração nativa pode cuidar dos gatilhos do provedor e da gravação dos resultados com as permissões concedidas à sua instalação. Um executor da CLI cuida da recuperação local e dos commits. Um cliente da API é responsável pelas revisões que armazena e pela ativação dos resultados. Escolha os contratos suportados que atendam a essas responsabilidades.

O Studio mantém a configuração e as decisões de tradução; o DevTools oferece execução programática e por arquivos; o Radar fornece as evidências disponíveis para medição e investigação. São recursos para combinar, não etapas que precisam ser adotadas em sequência.

Consulte a documentação do provedor escolhido sobre os modos manual e automático, o tratamento de rascunhos, os direitos de acesso e as consequências da desconexão. Uma conexão que publica em um CMS e outra que abre um pull request em um repositório não têm o mesmo ponto de aceitação.

Preserve a relação entre as revisões #

Mantenha vinculados a identidade do conteúdo, a revisão de origem, o idioma de destino, a revisão ou o artefato de saída, a configuração e a aceitação. Decida o que acontece se uma versão mais recente do conteúdo de origem chegar enquanto a tradução ou a revisão estiver em andamento. O resultado mais antigo não deve se tornar o atual só porque foi concluído por último.

Defina onde a reutilização deve preservar as traduções de destino aceitas e onde a intenção é gerar novas traduções. O suporte ao mesmo formato não significa que a API, a CLI e o aplicativo ofereçam opções idênticas. Preserve no projeto a versão de referência exata do cliente e o comportamento de execução forçada.

Planeje como lidar com os casos não resolvidos #

Defina o que acontece quando uma entrada é rejeitada, uma tradução de destino falha, a recuperação é interrompida, há espera por revisão, surge um conflito local ou a resposta é incerta. A próxima ação deve recuperar o trabalho já conhecido conforme o contrato aplicável, não recomeçar tudo porque um comprovante se perdeu.

Algumas traduções de destino concluídas podem ficar preparadas para entrega enquanto outra permanece pendente. Decida se a versão exige todas elas ou se pode usar uma alternativa de forma deliberada. A política de revisão define as consequências de decisões ausentes e prazos de espera esgotados. Mantenha os controles de execução na ferramenta responsável pelo trabalho, em vez de inventar uma ação universal de nova tentativa.

Torne as evidências de qualidade fáceis de interpretar #

Defina as perguntas relevantes para o lançamento, inclusive para traduções produzidas fora do Lingo.dev. Uma medição pode identificar o trabalho que precisa de revisão sem se tornar o sistema responsável pelo conteúdo aceito ou pelas decisões de publicação.

O projeto de medição explica os critérios, as evidências, os estados das respostas e os conjuntos analisados nos relatórios. Como parte do workflow, designe quem vai interpretar essas evidências e esclarecer dúvidas sobre o significado do conteúdo de origem.

Valide um ciclo completo antes de expandir #

Conduza uma alteração no conteúdo de origem pelas etapas de envio, recuperação, validação, revisão, entrega e uso. Em um teste seguro, altere o conteúdo de origem durante o processamento e simule a falha de uma tradução de destino. Verifique se a revisão atual continua identificável e se a recuperação preserva o resultado aceito.

Use um teste de workflow para registrar o que de fato foi executado e o que ainda não foi testado. O projeto estará pronto para expansão quando outro operador conseguir explicar tanto como uma tradução fica pronta para uso quanto como restaurar o estado anterior que atendia à necessidade.