Glossário é um sistema de decisões
Uma entrada útil registra termo preferido, definição, variantes proibidas ou obsoletas, contexto e owner.
Comece pelos conceitos com atrito
Priorize termos que causam suporte, labels inconsistentes, problemas de tradução ou disputas de review.
Separe conceito de rótulo
Um conceito pode ter vários nomes históricos. Modele uma vez e registre aliases.
Coloque terminologia no workflow
Use a mesma fonte para escrita, tradução e linting quando possível.
Dê owners e revisão
Produtos mudam. Terminologia precisa de manutenção contínua.
Exemplo aplicado
Aplique “Termos e definições: construindo um sistema terminológico” a uma página real. Escolha conteúdo com títulos, tabela, nota, exemplo, um termo repetido e pelo menos uma ação do leitor. Revise primeiro como autor e depois como alguém que não conhece o vocabulário interno.
Registre defeitos observáveis:
- que estrutura transmite significado ausente no texto simples;
- que termo muda de grafia ou significado;
- que instrução depende de contexto não declarado;
- que regra seria difícil revisar de modo consistente.
Um padrão é útil quando dois editores chegam a decisões parecidas sobre o mesmo conteúdo. Se a regra parece correta mas não pode ser demonstrada numa página representativa, refine a regra, acrescente exemplo ou reduza o escopo.
Checklist editorial rápido
- Glossário é um sistema de decisões. Uma entrada útil registra termo preferido, definição, variantes proibidas ou obsoletas, contexto e owner.
- Comece pelos conceitos com atrito. Priorize termos que causam suporte, labels inconsistentes, problemas de tradução ou disputas de review.
- Separe conceito de rótulo. Um conceito pode ter vários nomes históricos.
- Coloque terminologia no workflow. Use a mesma fonte para escrita, tradução e linting quando possível.
