Política Terminológica
Tradução técnica inconsistente destrói material de arquitetura. Um documento que alterna entre "acoplamento" e "coupling" obriga o leitor a decidir, a cada ocorrência, se os dois termos significam a mesma coisa.
Esta página é gerada a partir de scripts/terminology.json, que é também a
fonte que o linter usa. O que está aqui é exatamente o que o CI cobra.
Não edite esta página. Altere scripts/terminology.json e rode
npm run terminology.
Como ler as tabelas
A coluna Regra indica se o linter aplica a decisão automaticamente:
- ✅ aplicado — violar falha o build.
- — orientação — documentado, não automatizado. São os casos em que a decisão depende de contexto e a automação produziria falso positivo.
Um documento pode declarar terminology_exempt: [termo] no front matter para
sair da regra num caso justificado — citação literal, por exemplo.
Categoria A — Traduzir sempre
Termos com equivalente estabelecido em português técnico. O documento usa a forma em português como termo de trabalho.
A forma em inglês é permitida uma vez, como glosa de primeira ocorrência: "acoplamento (coupling)". Depois disso, só a forma em português.
| Inglês | Português | Regra |
|---|---|---|
| coupling | acoplamento | ✅ aplicado |
| cohesion | coesão | ✅ aplicado |
| availability | disponibilidade | ✅ aplicado |
| reliability | confiabilidade | ✅ aplicado |
| scalability | escalabilidade | ✅ aplicado |
| maintainability | manutenibilidade | ✅ aplicado |
| layer | camada | ✅ aplicado |
| eventual consistency | consistência eventual | ✅ aplicado |
| strong consistency | consistência forte | ✅ aplicado |
| technical debt | dívida técnica | ✅ aplicado |
| bottleneck | gargalo | ✅ aplicado |
| constraint | restrição | ✅ aplicado |
| deployment | implantação | ✅ aplicado |
| requirement | requisito | ✅ aplicado |
| boundary | fronteira | ✅ aplicado |
| throughput | vazão | — orientação |
| latency | latência | ✅ aplicado |
| redundancy | redundância | ✅ aplicado |
| fault tolerance | tolerância a falhas | ✅ aplicado |
| load balancing | balanceamento de carga | ✅ aplicado |
Categoria B — Manter em inglês
Termos em que traduzir prejudica o reconhecimento ou não há equivalente aceito. A coluna de traduções recusadas lista as formas que o linter rejeita.
| Termo | Traduções recusadas | Regra |
|---|---|---|
| trade-off | compromisso técnico · contrapartida | ✅ aplicado |
| bounded context | contexto limitado · contexto delimitado | ✅ aplicado |
| ubiquitous language | linguagem onipresente | ✅ aplicado |
| aggregate root | raiz do agregado | — orientação |
| event sourcing | fonte de eventos · obtenção de eventos | ✅ aplicado |
| sharding | fragmentação · estilhaçamento | ✅ aplicado |
| backpressure | contrapressão | ✅ aplicado |
| feature flag | sinalizador de recurso · bandeira de recurso | ✅ aplicado |
| service mesh | malha de serviços | ✅ aplicado |
| sidecar | carro lateral | ✅ aplicado |
| canary | canário | ✅ aplicado |
| blue/green | azul/verde | ✅ aplicado |
| strangler fig | figueira estranguladora | ✅ aplicado |
| CQRS | — | — orientação |
| commit | — | — orientação |
| anti-corruption layer | camada anticorrupção · camada de anticorrupção | ✅ aplicado |
| dead-letter queue | — | — orientação |
| event-driven | — | — orientação |
Categoria C — Inglês com glosa
Termos que permanecem em inglês, com a glosa em português na primeira ocorrência de cada documento e apenas o termo em inglês depois.
| Termo | Glosa sugerida |
|---|---|
| circuit breaker | disjuntor |
| bulkhead | anteparo |
| poison message | mensagem envenenada |
| dead-letter queue | fila de mensagens mortas |
| hotspot | ponto quente |
Nomes próprios
Nunca traduzidos, em nenhum contexto:
Strategy · Observer · Factory Method · Abstract Factory · Builder · Prototype · Singleton · Adapter · Bridge · Composite · Decorator · Facade · Flyweight · Proxy · Chain of Responsibility · Command · Iterator · Mediator · Memento · State · Template Method · Visitor · Ports and Adapters · Pipes and Filters · Strangler Fig · Clean Architecture · Space-Based Architecture · Team Topologies
A regra que não cabe em tabela
Sem meio-termo dentro de um documento. Escolhido um vocabulário, ele vale do início ao fim. O linter detecta alternância entre a forma em português e a forma em inglês fora da janela de glosa, e falha.
Isso vale também no sentido inverso: um documento em inglês que contenha o termo em português é rejeitado.