Conceber um processo de tradução
Transforme alterações ao conteúdo de origem em traduções utilizáveis, com responsabilidades, revisão, entrega e recuperação claramente definidas.
Um processo de tradução só fica completo quando uma alteração ao conteúdo de origem se torna conteúdo utilizável no sistema que dele precisa. A geração é apenas uma parte. O workflow também tem de identificar a revisão correta, obter as respetivas traduções de destino, preservar o trabalho aceite e decidir o que pode ser publicado.
Comece por conceber o processo para um tipo concreto de conteúdo: catálogos de repositório, artigos de CMS ou registos de aplicações. Cada um tem responsáveis e formas de entrega diferentes. Um workflow que trate os três da mesma forma pode ocultar as decisões que determinam se um resultado é seguro de utilizar.
Identificar quem é responsável por cada transição #
Um processo para catálogos de repositório pode assentar nestas decisões:
| Transição | Decisão |
|---|---|
| O conteúdo de origem torna-se elegível | Traduzir conteúdo de origem revisto num commit registado, a partir de um gatilho de confiança que exclua as traduções de destino geradas. |
| O trabalho começa | Utilizar o motor de localização, os idiomas, o formato e as versões de referência aceites explicitamente definidos; obter aprovação para a execução quando necessário. |
| As traduções de destino tornam-se aceitáveis | As pessoas designadas para a revisão verificam as alterações necessárias, e os casos por resolver permanecem visíveis. |
| O resultado regressa | Os recursos descarregados e validados são incluídos num pedido de integração de traduções. |
| O conteúdo chega a quem o lê | A versão da aplicação integra a alteração e passa nas verificações dos recursos. |
| É necessário reverter um resultado | Restaurar recursos comprovadamente válidos e a configuração ou as versões de referência relevantes. |
Este é um exemplo de conceção de um workflow, não uma predefinição do produto. Identifique o mecanismo concreto que faz cumprir cada decisão. Se uma política da equipa não tiver um controlo automático, é necessário designar alguém para verificar o seu cumprimento.
Escolher ferramentas de acordo com as suas responsabilidades #
Uma integração nativa pode gerir os gatilhos do fornecedor e a escrita dos resultados no sistema de origem, ao abrigo das permissões concedidas na instalação. Um executor da CLI é responsável pela obtenção local e pelos commits. Um cliente da API é responsável pelas revisões que armazena e pela ativação dos resultados. Escolha os contratos suportados que melhor se adequam a essas responsabilidades.
O Studio mantém a configuração e as decisões de tradução; o DevTools permite a execução programática e através de ficheiros; o Radar disponibiliza os dados de suporte disponíveis para medição e investigação. São capacidades que se podem combinar, não etapas que tenham de ser adotadas numa sequência obrigatória.
Informe-se sobre os modos manual e automático do fornecedor escolhido, o tratamento de rascunhos, os direitos de acesso e as consequências de desligar a ligação. Uma ligação que publica num CMS e outra que abre um pedido de integração num repositório não têm o mesmo ponto de aceitação.
Manter intacta a relação entre revisões #
Mantenha associados a identidade do conteúdo, a revisão de origem, o idioma de destino, a revisão ou o artefacto de saída, a configuração e a aceitação. Decida o que acontece se chegar uma revisão de origem mais recente enquanto a tradução ou a revisão está em curso. O resultado mais antigo não pode tornar-se o atual só por ser o último a ficar concluído.
Defina em que casos a reutilização preserva as traduções de destino aceites e em quais se pretende gerar novas traduções. O suporte do mesmo formato não garante opções idênticas na API, na CLI e na aplicação. Contemple na conceção a versão de referência exata do cliente e o comportamento da geração forçada.
Planear como lidar com os casos por resolver #
Defina o que acontece após a rejeição dos dados de entrada, uma falha numa tradução de destino, uma interrupção na obtenção dos resultados, uma espera por revisão, um conflito local ou uma resposta incerta. A ação seguinte deve recuperar o trabalho conhecido nos termos do respetivo contrato, não recomeçar tudo por se ter perdido um comprovativo.
Algumas traduções de destino concluídas podem ficar preparadas enquanto outra permanece por resolver. Decida se a publicação exige todas as traduções ou se pode recorrer deliberadamente a uma alternativa. A política de revisão define as consequências das decisões em falta e dos tempos limite excedidos. Mantenha os controlos de execução na ferramenta responsável pelo trabalho, em vez de inventar uma ação universal para repetir tentativas.
Tornar os dados de qualidade interpretáveis #
Defina as questões relevantes para a publicação, incluindo as que dizem respeito a traduções produzidas fora do Lingo.dev. Uma medição pode identificar trabalho que precisa de revisão sem se tornar o sistema responsável pelo conteúdo aceite ou pela decisão de publicação.
A conceção da medição explica os critérios, os dados de suporte, os estados das respostas e as populações abrangidas pelos relatórios. Como parte do workflow, designe as pessoas que vão interpretar esses dados e esclarecer as incertezas sobre o significado do conteúdo de origem.
Validar um ciclo completo antes de alargar o processo #
Percorra as etapas de submissão, obtenção, validação, revisão, entrega e utilização com uma alteração ao conteúdo de origem. Num teste seguro, altere o conteúdo de origem durante o processamento e simule uma falha numa tradução de destino. Verifique se a revisão atual continua a ser identificável e se a recuperação preserva os resultados aceites.
Utilize um teste do workflow para registar o que foi efetivamente executado e o que continua por testar. O processo está pronto para ser alargado quando outra pessoa responsável pela operação conseguir explicar tanto como uma tradução se torna utilizável como de que forma se restaura o estado útil anterior.