Como revisar termos técnicos, uso de maiúsculas e rótulos traduzidos
Ao revisar documentações técnicas, verifique cada termo em relação a uma tabela de termos explícita em vez de confiar na memória ou em uma única regra de capitalização. Registre a forma aprovada, a ortografia e as maiúsculas/minúsculas que os leitores devem ver, variantes aceitáveis, identificadores literais de código ou de API e qualquer tradução que ainda aguarde uma decisão. Em seguida, revise o texto corrido, os rótulos de interface e os identificadores como elementos distintos. Esse método detecta terminologias inconsistentes e, ao mesmo tempo, preserva nomes e códigos que precisam permanecer exatos.
Por que uma única regra de capitalização não resolve todos os termos?
Guias de estilo oferecem padrões úteis, mas um produto ou domínio pode ter nomes estabelecidos que exigem um tratamento diferente. O guia para desenvolvedores do Google recomenda a capitalização padrão do inglês americano e formato de frase (sentence case) para títulos, listas e tabelas, preservando nomes oficiais de produtos e formas em código. O guia da Microsoft também privilegia a capitalização em formato de frase, mas reserva explicitamente as iniciais maiúsculas para substantivos próprios, como suas marcas, produtos e serviços. O padrão compartilhado por eles é um ponto de partida, não a prova de que um determinado termo técnico seja genérico. [Diretrizes de capitalização do Google](https://developers.google.com/style/capitalization) [Diretrizes de capitalização da Microsoft](https://learn.microsoft.com/en-us/style-guide/capitalization)
Uma lista de palavras pode responder a uma pergunta diferente daquela tratada em uma página geral de regras de maiúsculas e minúsculas: qual ortografia ou uso um guia editorial específico prefere para determinados termos. A lista de palavras do Google, por exemplo, encaminha os leitores ao seu dicionário de preferência para verbetes que ela não cobre e distingue as orientações de estilo da verificação de uma definição técnica em uma documentação oficial. Essa separação é útil: a consistência editorial e a precisão técnica exigem evidências das fontes mais adequadas a cada questão. [Lista de palavras do Google](https://developers.google.com/style/word-list)
O que deve constar em uma tabela de termos para revisão?
Crie uma linha para cada termo que possa ser alterado de maneira inconsistente ou traduzido incorretamente. Este exemplo hipotético mostra os campos e a lógica de decisão; “Sync token” e sua tradução são ilustrativos, não afirmações sobre um produto real ou terminologia aprovada.
A função da tabela é registrar decisões e seus limites. Uma forma em minúsculas permitida não deve se transformar silenciosamente em um segundo nome de produto; um identificador não deve ser “corrigido” para se alinhar ao texto corrido; e uma tradução pendente deve permanecer visivelmente não resolvida. Quando uma fonte oficial entrar em conflito com um glossário local, registre o conflito e a fonte da decisão final em vez de mesclar as formas em uma lista sem explicações.
Como definir a ortografia e as maiúsculas/minúsculas de exibição?
Primeiro, identifique a que o termo se refere: um conceito comum, um nome de marca ou produto, um rótulo de interface de usuário (UI) ou um identificador literal. Consulte a documentação relevante do produto ou o glossário para obter a forma oficial. Em seguida, aplique as regras de estilo da publicação de destino a textos comuns, títulos e rótulos, mantendo as exceções documentadas para nomes e identificadores. O Google desaconselha o uso desnecessário de maiúsculas e adverte contra o uso exclusivo de maiúsculas/minúsculas para diferenciar significados; da mesma forma, a Microsoft recomenda o uso de minúsculas, exceto no início de frases e em substantivos próprios, de acordo com sua abordagem de formato de frase. [Diretrizes de capitalização do Google](https://developers.google.com/style/capitalization) [Diretrizes de capitalização da Microsoft](https://learn.microsoft.com/en-us/style-guide/capitalization)
Em seguida, compare a forma com a lista de palavras e o dicionário da organização de destino, quando apropriado. Registre a fonte e sua versão ou data de verificação para que outro editor possa rastrear a escolha. Não deduza o status oficial a partir de uma grafia atraente com iniciais maiúsculas, de um resultado de busca ou de uma tradução que se pareça com o termo em inglês. Se as fontes divergirem ou não especificarem a forma, sinalize a linha para uma decisão em vez de apresentar uma suposição como terminologia consolidada.
Como os rótulos de interface e as traduções devem ser verificados?
Trate a tradução como uma decisão de significado e contexto, e não como uma conversão mecânica de maiúsculas e minúsculas. Um rótulo pode ser limitado pelo espaço da interface, pela terminologia já estabelecida do produto no idioma local ou por uma estrutura gramatical diferente no idioma de destino. Compare a opção candidata com materiais localizados aprovados e com o contexto em que os leitores a encontrarão. Se nenhuma forma localizada autorizada estiver disponível, marque a tradução como pendente e solicite a devida definição terminológica; não invente um equivalente supostamente oficial.
Após a definição do termo, revise o rótulo propriamente dito em seu local de exibição. Verifique se o uso de maiúsculas segue as regras do idioma escolhido e o estilo aplicável do produto ou da empresa. Mantenha o rótulo original visível no registro do termo, ao lado de sua fonte e status, para que uma edição futura não confunda uma tradução temporária com uma aprovada. Se o rótulo também for citado em instruções, certifique-se de que o texto mencione exatamente a mesma redação exibida na tela.
Como proteger identificadores de código e de API?
Separe as strings literais do texto editorial antes de alterar maiúsculas ou minúsculas. Compare os identificadores caractere por caractere com a referência da API, o esquema, o código ou a interface relevante. Preserve sublinhados (underscores), maiúsculas, espaçamento e pontuação onde a fonte os definir; a normalização de estilo pertence à explicação ao redor, não a um valor literal. O guia do Google permite especificamente formas totalmente em maiúsculas ou em camelCase em nomes oficiais ou ao fazer referência a códigos que os utilizam. [Diretrizes de capitalização do Google](https://developers.google.com/style/capitalization)
Uma revisão prática sinaliza identificadores protegidos na tabela de termos e, em seguida, confere cada ocorrência com base nessa referência. Se uma frase no texto corrido usar um termo em formato de código como um substantivo comum, decida se vale explicá-lo com palavras mais acessíveis ao leitor, mantendo o identificador literal intacto na formatação de código. Quando a própria definição oficial for incerta, registre essa dúvida; um guia de estilo não pode determinar o comportamento de uma API nem o nome canônico de um campo.
Qual é uma sequência de revisão confiável?
Esta sequência é um suporte para a revisão, e não uma tradução automática ou uma regra universal para maiúsculas e minúsculas. Seu valor está em tornar cada decisão editorial auditável: qual forma foi escolhida, de onde ela veio, onde ela se aplica e o que ainda requer uma decisão. Para um documento curto, uma tabela compacta pode ser suficiente; para um conjunto terminológico extenso, mantenha os mesmos campos no fluxo de trabalho de glossário já estabelecido pela equipe.