Notas para tradutores na CLI v0

Acrescente o significado específico de cada ocorrência junto das mensagens em JSONC ou Xcode no sistema legado e solicite explicitamente uma nova tradução do texto afetado.

Um rótulo curto deixa muitas vezes de fora informações de que um tradutor precisa. Uma nota pode identificar o assunto, a ação ou o registo sem acrescentar palavras visíveis à interface. No workflow legado, use comentários JSONC ou os campos de comentário nativos dos catálogos Xcode, quando forem suportados.

Explique o significado em falta #

jsonc
{
  // Patient medical records, not music recordings
  "records": "Records",
  // Button that submits the form; use a short action label
  "submit": "Submit",
  // Visual theme, not weight
  "theme.light": "Light"
}

Selecione o analisador com suporte para comentários em i18n.json:

json
{
  "buckets": {
    "jsonc": { "include": ["locales/[locale].jsonc"] }
  }
}

«Coleção de registos médicos guardados» esclarece o assunto; «Texto apresentado a um utilizador» não. Uma nota sobre a posição na interface e o registo pode explicar por que motivo um aviso formal difere de um rótulo de ação. Use um controlo de chaves para um valor exato que não pode ser alterado, em vez de confiar numa nota linguística para o proteger.

Verifique o resultado afetado #

Alterar apenas a nota pode não alterar a soma de verificação do valor de origem. Solicite uma nova tradução dos textos selecionados quando, de outro modo, a versão instalada ignoraria o texto inalterado. Leia o rótulo traduzido no contexto real da interface.

Para XCStrings, use o campo de comentário nativo e preserve a estrutura de idiomas do catálogo partilhado. Consulte os formatos legados antes de assumir que outro agrupamento lê as notas da mesma forma. Estes comentários legados não fazem parte do contrato de hash/contexto do catálogo React atual.

Mantenha cada nota específica de uma ocorrência separada do glossário, das regras e da voz que se aplicam a todo o motor de localização. Tanto a nota como estes recursos podem ser enviados para o servidor, pelo que nenhum deles deve conter segredos ou conteúdo que não tenha autorização para divulgar.