Contenu

Baldir

Marc Bouvier

Développeur logiciel en quête du sens dans un monde aux ressources limitées.

Club de lecture de code (Code reading club)

Glossaire

Le réunir régulièrement en petit groupe pour lire du code et améliorer cette pratique.

https://codereading.club/

Un club de lecture de code ressemble un peu à un club de lecture et un peu comme un jeu d'évasion.

Un petit groupe se réunit régulièrement pour lire des petits morceaux de code. Chaque session est facilitée par un membre du groupe qui a sélectionné l'exemple de code pour l'occasion. Cette personne guide le groupe au travers une série d'exercices exploratoires. Au fil du temps, le groupe améliore sa technique par la pratique et en expérimentant avec de nouvelles approches.

Les développeur-euses expérimenté-es savent que leur travail consiste invariablement à lire plus de code qu'on en écrit. Cependant, peu d'attention est donnée à la technique de lecture de code. En exerçant activement ces muscles, les bénéfices sont immédiats et c'est amusant. Dans un cadre proffessionel et commercial, un club de lecture de code est un outil collaboratif pour aider les équipes à :


Exemple du résultat d'une session de club de lecture de code.

First Glance. First I noticed. Then I noticed. I think these 2 things jumped at me because

What are we thinking ? I'm wondering about… I want to share…

Names of things. List the names. Patterns & anomalies. Domain. Programming concept.

Important lines. 4 line numbers. Why I chose them.

Summary ?? One thing I think it does.

Reflect. It was good when… It was not good when…

Outil d'annotation de code : https://annotate.codereading.club/#/

Ressources : https://github.com/CodeReadingClubs/Resources

Article original de Felienne Hermans : https://www.felienne.com/archives/6472