Escrever um documento de orientação para a localização

Explique o que os leitores devem compreender, que decisões a tradução deve preservar e quem pode esclarecer dúvidas sobre o resultado.

Ao rever conteúdo, toma decisões que a frase, por si só, pode não explicar por completo. Um termo designa um conceito específico do produto. Uma ressalva garante o rigor de uma afirmação. A ordem dos argumentos ajuda os leitores a perceber por que razão algo é importante. Um documento de orientação para a localização dá a quem traduz acesso a essas decisões.

Mantenha o documento de orientação ancorado no conteúdo de origem. A sua função é explicar o significado e o efeito pretendido, não dar liberdade a quem traduz para inventar novos factos ou promessas sobre o produto.

Comece pela situação do leitor #

Descreva quem vai ler o texto e o que precisa de compreender ou fazer. Um idioma identifica um público linguístico; não indica se o texto é uma primeira apresentação, um aviso ou uma resposta a um problema.

Mantenha disponíveis o excerto de origem e a respetiva versão. Acrescente definições de conceitos do produto, provas que sustentem as afirmações ou contexto adicional sempre que influenciem a interpretação. Identifique quem pode esclarecer o significado do texto de origem e quem tem as qualificações necessárias para avaliar a redação no idioma de destino.

Indique a região, o sistema de escrita e o registo linguístico quando forem relevantes. Um código de idioma, por si só, pode não ser suficiente para determinar a forma de tratamento adequada ou a redação exigida.

Dê ao documento de orientação o detalhe necessário para ser útil #

Para uma mensagem de convite na ExampleApp, o documento de orientação poderia ter o seguinte conteúdo:

PerguntaOrientações
O que está a ser traduzido?Uma mensagem de convite numa versão registada do texto de origem: «Um administrador tem de aprovar o convite antes de ser concedido o acesso.»
Quem lê a mensagem?Uma pessoa da equipa que aguarda para entrar no workspace partilhado da ExampleApp.
O que deve compreender?O acesso depende da aprovação prévia de um administrador; o convite, por si só, não concede acesso.
Que termo precisa de contexto?«Workspace» designa a área de projetos partilhada do produto, não um escritório físico.
O que deve manter-se intacto?A obrigatoriedade da aprovação, o facto de ter de preceder o acesso e quaisquer variáveis ou destinos fornecidos pela aplicação.
Quem esclarece as dúvidas?A pessoa responsável pelo produto confirma como funciona o acesso; um revisor qualificado no idioma avalia a redação; a pessoa responsável pelo conteúdo aprova a publicação.

Antes de traduzir, confirme a afirmação do texto de origem com a pessoa responsável. Se o requisito não for claro ou estiver incorreto, corrija primeiro o texto de origem.

Explique a relação que deve ser preservada #

No exemplo, não basta manter as palavras que designam aprovação e acesso. A tradução tem de preservar a obrigatoriedade da aprovação e o facto de esta ter de ocorrer primeiro. Uma frase natural com uma estrutura diferente pode cumprir as orientações; uma frase que torne a aprovação opcional não pode.

Acrescente um contraexemplo quando isso ajudar a esclarecer os limites. «Um administrador pode aprovar o convite depois de ser concedido o acesso» altera tanto a obrigação como a ordem. Assim, o erro fica mais claro do que com um pedido de semelhança literal com o texto de origem.

Aplique o mesmo raciocínio a uma ação ou a um argumento. Quem traduz pode escolher uma formulação natural para um destino existente ou uma razão que sustente o argumento, mas não deve criar uma nova ação, um compromisso de serviço ou um elemento de prova.

Separe o contexto do excerto das orientações partilhadas #

Mantenha os factos específicos do excerto junto dele. Coloque a terminologia, as instruções e as orientações de voz recorrentes no recurso partilhado adequado. Duplicar cada requisito nos três recursos cria cópias que podem divergir ou contradizer-se.

Recorra às decisões sobre a conversão de correções em regras antes de transformar uma alteração pontual em orientações partilhadas. Resolva os requisitos contraditórios na sua origem e mantenha a frase aceite restrita ao contexto em causa até ser aprovada uma aplicação mais ampla.

Disponibilize o contexto através de um mecanismo suportado #

Para quem faz chamadas à API, utilize os campos de contexto e de indicação efetivamente disponibilizados por essa interface. Para ficheiros, siga o processador de formato relevante. Um comentário preservado só serve de orientação para quem traduz se o processador o transmitir.

Siga Traduzir até ao workflow selecionado e guarde, juntamente com o resultado, a versão do texto de origem e a configuração associadas ao documento de orientação. Depois, compare a tradução com o significado pretendido, a terminologia, a estrutura e os requisitos do público. Visualize-a no formato final sempre que as variáveis, as ligações ou a disposição afetem a utilização.

Se o resultado não cumprir o pretendido, identifique o requisito exato que falhou. Se o documento de orientação for ambíguo, reveja a definição em causa e registe a alteração. Um documento de orientação completo permite que outra pessoa explique a decisão de tradução sem depender da presença de quem escreveu o original.