A Lista de Verificação de Confiabilidade de Tradução do Contentful

Uma tradução pode ser linguisticamente excelente e ainda assim comprometer o lançamento.

O snapshot da fonte errado pode ter sido usado. A estrutura de rich text pode ter mudado. Um valor revisado pode não ter chegado ao Contentful. A atualização pode estar presente, mas não publicada. A confiabilidade vem de proteger todo o caminho, não de otimizar a resposta de um único modelo.

Antes da tradução

Comece com um limite claro da fonte.

• identifique a entrada e o ambiente exatos do Contentful
• capture os locales de origem e destino
• carregue apenas os campos elegíveis para tradução
• preserve links, embeds, marks e a estrutura não traduzível
• registre o modelo, o prompt e as regras terminológicas
• mostre se campos de origem em branco estão incluídos

Se o escopo da solicitação for ambíguo antes da geração, cada fase posterior herdará essa ambiguidade.

Durante a geração

A chamada ao provedor deve ser observável e repetível o suficiente para dar suporte à revisão.

Valide se a resposta contém todos os campos esperados e placeholders protegidos. Rejeite saídas estruturadas malformadas em vez de tentar salvar as partes que parecem plausíveis.

As tentativas devem reutilizar o mesmo escopo da solicitação. Se um modelo ou prompt diferente for selecionado, trate o resultado como uma nova tentativa para que os revisores possam entender por que o rascunho mudou.

Durante a revisão

A revisão precisa de três estados lado a lado:

1. o valor de origem usado para a tradução
2. o valor de destino atual no Contentful
3. o rascunho localizado proposto

Isso revela dados de origem desatualizados e protege o trabalho de localização existente.

Para rich text, revise tanto a linguagem quanto a hierarquia. Abra a pré-visualização do CMS antes da aprovação quando layout, links ou conteúdo incorporado afetarem a página.

As edições feitas pelo revisor devem passar a fazer parte do histórico salvo do rascunho, em vez de desaparecerem em um envio final.

Durante o envio

Grave a menor mudança possível.

Envie apenas os campos aprovados do locale de destino. Busque novamente a entrada atual do Contentful, preserve valores não relacionados e use a versão mais recente da entrada. Se o mesmo campo de destino tiver mudado depois que a revisão começou, interrompa para uma decisão em vez de sobrescrevê-lo automaticamente.

Registre quais campos o Contentful aceitou e quando. Uma resposta de API bem-sucedida deve ser mapeada para um estado durável da solicitação antes que a UI anuncie a conclusão.

Durante a publicação

Envio e publicação são resultados separados.

Confirme se a entrada está elegível para o modo de publicação configurado e se o usuário tem permissão para publicar. Se a publicação for automática, mantenha sua falha independente do sucesso da tradução e do envio.

A solicitação deve mostrar claramente "enviado, publicação falhou" em vez de colapsar todo o fluxo de trabalho em uma falha genérica.

Durante a recuperação

Sistemas confiáveis assumem que provedores expiram por tempo limite, redes sofrem interrupções e versões do CMS entram em conflito.

• repita erros transitórios dentro de limites definidos
• retome a partir da fase com falha
• mantenha intactas as traduções e os envios bem-sucedidos
• exponha o erro acionável mais recente
• permita cancelamento onde o trabalho ativo possa parar com segurança
• torne o estado final recuperável por polling mesmo sem eventos em tempo real

A recuperação deve preservar o trabalho, não reiniciá-lo por reflexo.

Conclusão

Não existe um único recurso de confiabilidade para tradução no Contentful.

A confiança vem de salvaguardas específicas em cada limite: escopo explícito, estrutura protegida, estados de revisão comparáveis, gravações mínimas, estado de publicação separado e recuperação ciente da fase. Quando esses controles funcionam juntos, as equipes podem avançar rapidamente sem tratar cada lançamento multilíngue como uma aposta.