How to make your reviewer fall in love with you
Conseils pratiques de Michael Lynch pour transformer la code review en expérience collaborative et bienveillante
Cette sketchnote s'inspire de l'article de Michael Lynch "How to Make Your Code Reviewer Fall in Love with You". Le concept central : traiter son code comme une lettre d'amour pour transformer la code review en moment d'échange constructif.
Contenu
Lynch propose de changer de perspective sur la code review en valorisant le temps du reviewer et en facilitant sa compréhension. L'approche met l'accent sur des techniques pratiques : écrire des descriptions claires, limiter le scope à une idée par PR, automatiser le formatage, et maintenir une attitude humble et collaborative.
La sketchnote illustre les conseils essentiels : "Don't let them wait for nothing", "Write them clean change list", "Be humble, everyone can be wrong", et "Respond with more clear code". L'objectif est de créer une expérience fluide qui bénéficie autant au développeur qu'au reviewer.
Points clés à retenir
- Valoriser le temps : Préparation minutieuse et contexte complet pour éviter les allers-retours
- Une idée à la fois : Limiter chaque PR à une seule fonctionnalité ou correction
- Communication claire : Descriptions détaillées et commentaires explicatifs quand nécessaire
- Collaboration bienveillante : Humilité, réactivité et esprit d'équipe pour des reviews constructives
Cette sketchnote est disponible dans un carnet physique.