Code review é a leitura das suas mudanças por outra pessoa antes de elas virarem parte do projeto. Na prática, quase sempre acontece dentro de um pull request: você sobe uma branch, abre o pedido e quem revisa vê exatamente o que mudou, comenta e aprova ou pede ajustes. Se você ainda está pegando o jeito das branches, vale ler antes Git no dia a dia: commit, branch e como desfazer erros sem pânico.
O que o pull request precisa ter para ser revisável
Boa revisão começa em quem abre o pedido. Um pull request difícil de ler recebe comentários superficiais ou fica parado.
- Mudança pequena e com um só objetivo. Misturar correção de bug com reformatação de arquivos esconde problemas.
- Título que diz o que mudou, não só o número da tarefa.
- Descrição curta com o motivo da mudança, como testar e o que ficou de fora de propósito.
- Testes ou, quando não há, uma explicação de como você verificou o resultado.
Como regra geral, quanto maior o pull request, pior a qualidade da revisão. Se o diff passa de algumas centenas de linhas, pense em dividir.
O que olhar ao revisar
Não precisa checar tudo com a mesma intensidade. Uma ordem útil:
- O objetivo: a mudança resolve o que a descrição diz?
- Erros de lógica: casos de borda, valores vazios, falhas de rede, divisão por zero.
- Segurança: dados do usuário sem validação, senhas ou chaves no código, consultas montadas na mão.
- Testes: cobrem o comportamento novo e o que poderia quebrar?
- Legibilidade: nomes claros, funções que cabem na tela, comentários só onde o código não se explica.
Estilo e formatação, como espaços e aspas, devem ficar com ferramentas automáticas, os linters e formatadores. Gastar comentário humano com isso é desperdício.
Como comentar sem criar atrito
O tom pesa tanto quanto o conteúdo. Alguns hábitos ajudam:
- Comente o código, não a pessoa. Prefira "esta função pode receber lista vazia" a "você esqueceu de tratar".
- Pergunte quando não tiver certeza: "essa chamada precisa ser síncrona?".
- Separe o que bloqueia a aprovação do que é sugestão. Muita gente marca sugestões opcionais com um prefixo combinado no time, como "sugestão:".
- Explique o motivo. Um comentário com a razão ensina; um comando seco só gera cumprimento.
- Reconheça o que ficou bom. Também é parte da revisão.
Como manter o processo rápido
Revisão que demora dias trava o time e faz as branches divergirem, o que gera conflitos. Combine um prazo razoável para a primeira resposta e reserve horários fixos para revisar, em vez de interromper o trabalho a cada notificação.
Quem escreve também ajuda: responda aos comentários objetivamente, faça os ajustes em commits claros e avise quando estiver pronto para nova leitura. Quando a discussão se alonga por texto, uma conversa curta de voz costuma resolver mais rápido, e o resultado pode ser registrado no próprio pull request.
Por fim, automatize o que for possível: testes rodando a cada pedido, verificação de estilo e análise de dependências. Assim a pessoa que revisa usa a atenção no que só um humano percebe, como intenção, clareza e risco.