| name | escrita-academica |
| description | Padrão de linguagem para todo conteúdo textual do projeto (slides, materiais, páginas, autoestudos, READMEs e mensagens de commit). Registro acadêmico, formal, sucinto e contundente. Proíbe linguagem de marketing ou de redes sociais ("TikTok"): bordões, slogans, hype e tom de venda. Use ao escrever ou revisar qualquer texto destinado ao aluno ou à documentação. |
Escrita Acadêmica
Este repositório é material didático de ensino superior (Inteli). Todo texto destinado a alunos ou à documentação adota registro acadêmico, formal e técnico — sucinto, porém eloquente, e contundente nos enunciados normativos. Não é marketing, post de rede social nem texto promocional.
Princípio
A força do texto provém do rigor e da clareza, não do tom. Afirma-se com precisão e autoridade, sem apelo emocional, sem frase de efeito e sem informalidade.
A evitar (linguagem "TikTok" / marketing)
- Bordões e frases de efeito: "começa aqui, não termina aqui"; "baseline é piso, não teto"; "não é X — é Y".
- Aforismos publicitários: "arquitetura não é o diagrama bonito — é..."; "documentação que não envelhece".
- Coloquialismos e metáforas de venda: "scan é dinheiro"; "produção nunca é cobaia"; "ruído mata observabilidade".
- Travessão usado para criar punch line ou suspense retórico.
- Apelo ao leitor, exclamações, hype ("revolucionário", "poderosíssimo") e emojis decorativos no corpo do texto.
- Listas infladas e conclusões vazias (o chamado slop de IA generativa).
A preferir (registro acadêmico)
- Enunciados normativos diretos: "deve", "é obrigatório", "constitui falha", "não se admite".
- Definições e justificativas formais: "Entende-se por X..."; "Tal exigência decorre de...".
- Voz impessoal ou terceira pessoa, frases curtas, um argumento por parágrafo.
- Termos técnicos consagrados preservados (em itálico ou
code quando couber).
- Língua portuguesa impecável: ortografia, acentuação e concordância corretas.
Exemplos de reescrita
| Evitar | Preferir |
|---|
| "Baseline é piso — começa aqui, não termina aqui." | "Este documento define o limiar mínimo de aceitação, não o objetivo final do trabalho." |
| "Arquitetura não é o diagrama bonito — é o conjunto de decisões caras de reverter." | "Entende-se por arquitetura o conjunto de decisões de difícil reversão." |
| "Pipeline que duplica linhas ao reexecutar é falha alta." | "A duplicação de registros em reexecuções evidencia ausência de idempotência e constitui falha de severidade alta." |
| "Produção nunca é cobaia." | "O ambiente de produção não é utilizado para experimentação." |
| "Funciona na minha máquina não é entrega." | "A impossibilidade de reproduzir o ambiente a partir do repositório invalida a entrega." |
Checklist antes de publicar qualquer texto
- Há bordão, slogan ou frase de efeito? Reescrever como enunciado.
- Há coloquialismo, gíria ou metáfora de venda? Substituir por termo técnico.
- O tom é impessoal e assertivo, sem apelo emocional?
- A língua portuguesa está impecável, acentuação inclusive?
- O texto é sucinto, sem listas infladas nem conclusões vazias?
