A Lei da Trivialidade de Parkinson no GitHub
Mande um PR de 1.800 linhas misturando refatoração cosmética de dez arquivos, uma migration e a regra nova de desconto: em três minutos alguém aprova com "LGTM" porque ninguém tem duas horas livres para ler tudo aquilo antes da daily.
Mande um PR limpo de 40 linhas e o time abre uma conferência filosófica de doze comentários discutindo se a função devia se chamar `getUser` ou `fetchUser`. Esse desequilíbrio é a razão de tantos bugs óbvios passarem ilesos até produção.
5 regras secas para Pull Requests que alguém realmente lê
Adote cinco combinados simples no time para parar de transformar revisão de código em guerra de ego ou carimbo cego:
- 1. Limite de tamanho (~300 linhas úteis): se a feature é grande, suba em etapas protegidas por feature flag ou PRs empilhados.
- 2. Nunca misture refactor cosmético com mudança de regra de negócio no mesmo diff.
- 3. Automação paga o pedágio chato: lint, tipagem e formatação rodam no CI antes mesmo de notificar o revisor humano.
- 4. Descrição explica o "porquê" e como testar, não repete o título do ticket do Jira.
- 5. Marque comentários não bloqueantes com [nit] para não travar um merge válido por preferência estética.
Checklist de 5 minutos para o revisor
Olhe primeiro para fronteiras perigosas: validação de entrada de usuário, queries SQL sem índice ou transação, mudança de contrato de API/Redis e tratamento real de erro (sem engolir exceção silenciosamente).
PR Tóxico / Inútil vs. Pull Request de Engenharia Madura
| Item | Padrão Caótico | Padrão Recomendado |
|---|---|---|
| Tamanho do diff | 1.800+ linhas em 45 arquivos | Até 300 linhas por entrega incremental |
| Estilo e formatação | 12 comentários manuais no review | OxFmt / Prettier / ESLint bloqueando no CI |
| Tom dos comentários | "Por que você escreveu isso assim?" | "[bloqueador] Sem índice aqui vai dar seq scan na tabela X" |
| Resultado típico | "LGTM" cego seguido de rollback | Bugs estruturais capturados antes do merge |
Leia também
- Migration sem downtime no PostgreSQL
Um dos itens mais importantes para conferir em qualquer PR que toca banco de dados.
- Debug de erro intermitente em produção
Veja quais erros de concorrência costumam passar batidos em PRs gigantes.
Perguntas Frequentes (FAQ)
Como diminuir o tamanho do PR quando a tarefa envolve mudança grande de arquitetura?
Separe em pelo menos três entregas: primeiro o refactor preparatório ou criação de tabela/endpoint atrás de flag (sem impacto ativo), depois a lógica principal e por fim a remoção do código legado.
Quanto tempo um PR deve esperar por revisão?
Em times saudáveis, a primeira revisão acontece em menos de 4 horas úteis. PR parado há quatro dias gera conflito de merge e força o autor a perder contexto para ajustar.
O autor deve revisar o próprio código antes de pedir review aos colegas?
Sempre. Ler o próprio diff no GitHub antes de marcar revisores elimina metade dos erros bobos, imports sobrando e logs esquecidos.
Referências e Fontes
- Google Engineering Practices — How to do a Code Review & Small CLs — Google Engineering Practices Documentation