Decisões
ORG-0003 — Idioma e terminologia
- Status: aceita
- Data: 2026-10-18
- Decide: português brasileiro no que se lê, inglês nos identificadores, termos técnicos consagrados sem tradução
Contexto
A Hibex escreve para pessoas que leem português e trabalha com ferramentas, bibliotecas e convenções em inglês. Misturar os dois sem regra produz identificadores traduzidos pela metade e documentos que trocam de idioma no meio.
Decisão
- Português brasileiro em documentação, specs (prosa), telas e respostas do agente.
- Inglês em identificadores: código, nomes de serviço, realm, client, tabela, variável.
- Termos técnicos consagrados não se traduzem (commit, build, deploy, container, realm, endpoint…).
- Nas specs do OpenSpec, as palavras-chave
SHALL/MUST/WHEN/THENficam em inglês. - A terminologia do domínio mora na stack, em
docs/produto/glossario.md: começa vazia e cresce a cada change que cria um termo.
Alternativas consideradas
| Alternativa | Por que não |
|---|---|
| Tudo em inglês | Por que não: quem usa e mantém os produtos lê português; specs e telas ficariam mais distantes do negócio |
| Identificadores em português | Por que não: atrito com bibliotecas, convenções e exemplos, todos em inglês |
Consequências
- Um glossário por stack, mantido pelas changes, evita sinônimos para a mesma coisa.
- Revisões apontam termo traduzido sem necessidade e identificador em português.
Mais
O detalhe está na documentação da arquitetura.