Preserve traduções revisadas durante as atualizações

Mantenha juntas as versões de referência do conteúdo de origem e da tradução aceita, escolha o modo de atualização adequado e verifique exatamente o que mudou.

Uma tradução aceita representa um trabalho que vale a pena preservar. Quando uma mensagem de origem muda, as mensagens próximas podem continuar corretas. A reutilização permite mantê-las quando o workflow recebe as versões de referência certas e aplica o comportamento de mesclagem desejado.

O termo “incremental”, por si só, não descreve essa proteção. Guarde o conteúdo de origem anterior e a tradução aceita, escolha o contrato de atualização de quem faz a chamada e confira as diferenças reais. Para corrigir um problema conhecido na tradução, use atualizações de uma única chave; se um trabalho enviado foi interrompido, comece pela recuperação.

Registre o que deve mudar e o que deve ser mantido #

Considere este exemplo de conteúdo de origem:

json
{
  "retention": "Reports remain available for 30 days.",
  "support": "Contact support",
  "productName": "ExampleApp"
}

O responsável pelo conteúdo de origem altera o prazo de retenção para 60 dias. Preserve a versão anterior do conteúdo de origem, a nova versão e a tradução revisada. O prazo na tradução deve mudar; a redação aceita de support deve permanecer. Manter productName idêntico ao conteúdo de origem é um requisito diferente de preservar uma expressão já revisada na tradução.

Salve a revisão mais recente da tradução aceita, incluindo as edições locais feitas desde o download e suas justificativas. A versão de referência do servidor e a tradução na árvore de trabalho podem já não ter o mesmo conteúdo.

Use o planejamento padrão de alterações incrementais quando o conteúdo de origem mudar #

O lingo push --wait padrão da CLI atual usa o estado registrado do conteúdo de origem e as traduções para planejar alterações. Mantenha a configuração, o conteúdo de origem, as traduções aceitas e .lingo/lock.json sob controle de versão. Excluir o Lockfile altera o planejamento; não é uma simples atualização sem consequências.

--backfill-missing preenche arquivos de destino ausentes, mas não todas as chaves ausentes ou alteradas nos arquivos existentes. Padrões de origem passados como argumentos posicionais usam um planejamento de escopo delimitado, com um comportamento de reutilização diferente. --force gera novamente os destinos selecionados em arquivos separados e pode substituir textos aceitos; catálogos XCStrings compartilhados ainda podem reutilizar as traduções incorporadas. Consulte a Referência de push para escolher a opção adequada antes de solicitar a substituição.

Confira o escopo e, quando for útil, faça uma estimativa antes de executar em larga escala. Depois de obter os resultados, compare o valor alterado e os valores aceitos próximos a ele. Confirme a preservação pelo resultado, não pelo nome dado à execução.

Diferencie o bloqueio do conteúdo de origem da preservação da tradução #

Uma chave bloqueada, quando o recurso é compatível com o formato, copia o texto de origem para o destino. Uma chave preservada mantém um valor de destino existente. Portanto, bloquear uma mensagem revisada em francês pode substituí-la pelo texto em inglês; isso não protege a redação em francês.

Os controles de chaves variam conforme o formato. Omitir uma chave da saída é outra operação. Um valor cujas informações de origem mudaram não deve ser preservado incondicionalmente, pois isso pode manter um significado desatualizado.

Concilie as correções locais ao obter os resultados #

Salve as correções existentes antes de enviar uma atualização. A versão exata da tradução capturada pelo push pode ser substituída como parte dessa atualização. Para detectar edições feitas após o envio, omita --wait e confira lingo pull --dry-run. O pull compara as traduções locais com a tradução capturada e os hashes registrados e pode se recusar a sobrescrever edições posteriores; o download direto de push --wait não faz essa nova verificação.

Em caso de conflito, compare a correção local, a tradução registrada e o resultado recebido com as revisões correspondentes do conteúdo de origem. Preserve as correções que continuarem válidas por meio do processo normal de revisão. Use lingo pull --force somente depois de salvar o trabalho local e optar deliberadamente pela substituição. Forçar a operação ignora a proteção; não determina qual redação está correta.

No caso de catálogos compartilhados da Apple, preserve o arquivo inteiro e confira os idiomas que não foram alterados. Não exclua um arquivo que contém o conteúdo de origem e vários idiomas como se fosse um arquivo de tradução descartável.

Aceite a nova versão de referência após a conferência #

No exemplo, verifique o prazo de 60 dias na nova tradução, o valor preservado de support e o comportamento desejado de productName. Confira as variáveis e a estrutura no ambiente de execução que consome o conteúdo. A comparação identifica as alterações; a revisão linguística determina se a nova afirmação está correta.

Guarde a tradução aceita junto com a revisão correspondente do conteúdo de origem como a próxima versão de referência. Se a correção exigir uma mudança nas orientações futuras, tome essa decisão separadamente no glossário ou nas regras, em vez de presumir que uma edição aceita ensina uma nova política ao engine de localização.