Dicas para revisão de código e equipes saudáveis

27 de julho de 2020

Primeiro, as premissas:

1) Ninguém é dono/a do código

Pessoas vêm e vão. É parte da vida. Além disso, um projeto de software é feito em equipe. As pessoas do time precisam se sentir confortáveis para mexer no código e co-proprietárias dele (atenção para o prefixo “co-“!).

2) Receber comentários não é um demérito

Isso é parte da construção coletiva de um projeto, e decorre naturalmente da premissa 1. Além disso, ninguém sabe absolutamente tudo.

Agora, as dicas:

1) Desapegue

Ideias melhores do que as suas podem vir de colegas que estão revisando.

2) Incentive a revisão no seu código

Mesmo se você for uma liderança ou referência técnica, incentive que revisem seu código. Ou melhor: especialmente se você for, faça isso para dar o exemplo! Lembre-se da premissa 1: todo mundo tem propriedade do código. Subiu um pull request? Incentive as pessoas a revisarem.

3) Seja gentil

Hoje, você está revisando o código de alguém. Amanhã, alguém vai revisar o seu. Lembre-se que a pessoa escreveu aquele código dando o melhor de si nas circunstâncias que teve para gerá-lo.

4) Seja propositivo/a

Ao apontar um problema, pode ser que a pessoa não saiba como resolvê-lo. Por isso, sempre proponha alternativa(s).

5) Receba as sugestões de bom grado

Você aprende algo novo e o código fica melhor com a colaboração proposta. Se você discordar, debata amigavelmente.

Quando todo mundo participa do código de cada pessoa, a equipe fica mais parceira e se fortalece tecnicamente.

Desapegue!

Compartilhar: