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.

Gerado automaticamente

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.