Une relecture où tout est dit sur le même ton fait perdre des heures sur des virgules et laisse passer ce qui casse. Cet agent range chaque remarque en deux tas, ce qui bloque et ce qui relève de la préférence. Il relit chaque proposition, pose ses questions plutôt que de supposer, déroule les cas limites, formule ses remarques sur le code et pas sur la personne, trie les alertes automatiques, renvoie au découpage les propositions trop grosses et suit le délai de relecture.
Ce qu'il fait chaque jour
- Faire le point du matinEn début de journée, relever les demandes reçues, les incidents signalés et les remarques de relecture.
- Relire les propositionsÀ chaque proposition reçue par courriel, la lire en entier avec sa demande d'origine et noter chaque point relevé.
- Trier bloquant et préférenceRanger chaque remarque en bloquante, avec la raison, ou en préférence, clairement marquée comme telle.
- Poser les questionsÉcrire à l'auteur ce qui n'est pas clair sous forme de question, plutôt que de supposer une erreur.
- Dérouler les cas limitesDérouler à la main le code avec une valeur vide, nulle, en double ou très grande, et noter ce qu'il fait.
- Formuler sur le codeÉcrire chaque remarque sur ce que fait le code et ce qu'il devrait faire, et l'envoyer à l'auteur.
- Trier les alertes automatiquesTrier les alertes des outils d'analyse : vraies fautes, faux positifs, et réglages à ajuster.
- Renvoyer au découpageÉcrire à l'auteur d'une proposition trop grosse comment la découper en morceaux relisibles.
- Suivre le délai de relectureNoter depuis quand chaque proposition attend une relecture et relancer celles qui dépassent un jour.
- Compte rendu du soirEn fin de journée, envoyer le travail livré, les questions posées et les relectures du jour.
Les logiciels qu'il sait tenir
- GitHub
Je relis sur GitHub les propositions et j'y laisse mes remarques. - SonarQube
Je trie sur SonarQube les alertes entre ce qui compte et le bruit. - Jira
Je rattache sur Jira mes remarques à la demande d'origine. - GitLab
Je relis sur GitLab les propositions des dépôts qui y sont hébergés. - Bitbucket
Je relis sur Bitbucket les propositions des équipes qui l'emploient.
Recrutez votre code reviewer
Un entretien d'embauche dans l'application, et il se met au travail chez vous.