Noticias

A revisão de código serve só para achar defeitos antes da entrega?

Murilo Moura Alencar
Murilo Moura Alencar

Quem vê a revisão de código como uma barreira de qualidade costuma perder boa parte do seu valor. Segundo Murilo Moura Alencar, Tech, People & Game Strategist, o ganho mais duradouro dessa prática está no que as pessoas aprendem quando leem o trabalho umas das outras, e não apenas nos erros que deixam de chegar ao produto. Um programador que só recebe uma lista de correções sai da conversa com o código ajustado, mas com a mesma dúvida de antes.

Revisão de código é a etapa em que uma ou mais pessoas leem uma alteração feita por outra antes de ela entrar na base principal do software. Em muitas equipes, o ritual vira fila burocrática: alguém abre a alteração, outro dá um aprovado apressado, e o assunto se encerra em minutos. O resultado parece eficiente no painel de tarefas, mas desperdiça a chance de espalhar conhecimento pela equipe e de discutir decisões que ficarão no sistema por muitos anos.

Por que a revisão virou uma caça a erros?

A ideia de que revisar é sinônimo de fiscalizar tem origem prática. Em equipes sob pressão de prazo, a revisão aparece como último filtro, e o revisor se sente responsável por tudo o que passar. Nessa lógica, o comentário típico é um apontamento seco: troque este nome, mova esta função, falta um teste. Cada observação pode estar certa, e ainda assim o autor da alteração não entende o raciocínio por trás dela.

O custo dessa postura é silencioso. O autor aprende a antecipar o gosto do revisor em vez de aprender o princípio, e o revisor se cansa de repetir as mesmas correções. Com o tempo, as discussões migram para detalhes de formatação, que uma ferramenta automática resolveria, enquanto as perguntas importantes ficam sem resposta: a estrutura escolhida facilita a mudança futura? O código comunica a intenção a quem o lê pela primeira vez?

O que muda quando o comentário explica o porquê?

Um comentário que ensina traz a razão da sugestão. Em vez de pedir que uma função seja dividida, o revisor explica que, do jeito que está, ela mistura leitura de dados e regras de negócio, o que dificulta testar cada parte. Quem recebe esse tipo de retorno leva um critério para decidir sozinho na próxima vez, e o critério vale mais do que a correção pontual.

Como observa Murilo Moura Alencar, o tom do comentário também conta: a pergunta aberta convida o autor a defender ou rever a escolha, enquanto a ordem direta encerra a conversa. Uma pergunta sobre o que acontece quando a lista chega vazia faz o autor enxergar o caso por conta própria, e esse caminho costuma fixar o aprendizado melhor do que a resposta pronta.

Quando o revisor também aprende?

A via de mão dupla é a parte menos comentada. Ler o código de outra pessoa expõe o revisor a soluções que ele não teria imaginado, a bibliotecas que desconhecia e a partes do sistema que nunca tocou. Em equipes em que os revisores são sempre os mesmos, esse benefício se concentra em poucos, e o restante do grupo fica de fora.

Fazer rodízio de quem revisa é um ajuste simples que espalha o repertório. O profissional mais novo revisando o trabalho de um colega experiente tem a chance de perguntar o que não entendeu, e a pergunta honesta muitas vezes revela um trecho confuso que ninguém mais ousaria questionar. De acordo com Murilo Moura Alencar, essa troca em ambos os sentidos transforma a revisão em instrumento de formação para toda a equipe, seja qual for o cargo de cada um.

Murilo Moura Alencar explica o papel da liderança

Para que a revisão ensine, alguém precisa dar o tom, e esse alguém é a liderança. Conforme informa Murilo Moura Alencar, uma equipe só trata a revisão como espaço de aprendizado quando enxerga que errar à vista dos colegas não gera punição. Se um comentário duro vira motivo de avaliação negativa, o autor passa a esconder dúvidas e a abrir alterações cada vez mais curtas e seguras, que pouco ensinam.

Cabe à liderança, portanto, combinar o que a revisão deve cobrir e o que fica para ferramentas automáticas, definir um tempo razoável de resposta e reconhecer o bom comentário com a mesma atenção dada à boa entrega. Sem esses acordos, a prática oscila entre o descaso e a rigidez, e nenhum dos dois extremos forma ninguém.

Alterações pequenas, conversas melhores

O tamanho da alteração influencia diretamente a qualidade da revisão. Uma mudança com centenas de linhas pede um esforço que poucos revisores conseguem dedicar, e o resultado é a aprovação por cansaço. Alterações pequenas e focadas, que tratam de uma única ideia, permitem uma leitura atenta e uma conversa que cabe na rotina.

A prática muda também o papel do autor, que passa a descrever na própria alteração o que pretende resolver e por que escolheu aquele caminho. Escrever essa descrição é um primeiro exercício de clareza: quem não consegue explicar a mudança em poucas linhas costuma ter descoberto, no processo, que ela ainda não está pronta. E o revisor, com o contexto à mão, gasta a energia na decisão, sem precisar decifrar a intenção do autor.

Medir o aprendizado, e não só a velocidade

Equipes costumam acompanhar o tempo que uma alteração leva até ser aprovada, e a métrica tem utilidade, porque filas longas travam o trabalho. O problema aparece quando ela é a única. Uma revisão mais rápida não é necessariamente melhor, e uma mais lenta pode estar cumprindo justamente a função de ensinar.

Sinais mais reveladores são qualitativos: os mesmos apontamentos deixam de se repetir de uma alteração para outra? Os autores começam a antecipar as perguntas dos revisores? Os novatos passam a revisar e a comentar com segurança? Segundo Murilo Moura Alencar, é nesse tipo de evidência que se vê se a prática está formando gente ou apenas liberando entregas, e a liderança que olha só o cronômetro deixa passar a parte que de fato fortalece o time.

You may also like

Comments are closed.

More in:Noticias