Lire, comprendre et améliorer une codebase

On passe plus de temps à lire du code qu’à en écrire. Comprendre l’existant, le tien comme celui des autres, est une compétence centrale du métier, et on l’enseigne rarement. Ce cours part de là.

Le but est de rendre du code existant plus clair, plus sûr et plus simple à faire évoluer, pour toi comme pour les personnes qui passeront après. On commence par la lecture : entrer dans une codebase inconnue sans s’y perdre. On outille ensuite la compréhension : nommer, repérer les smells, partager un vocabulaire. Enfin on améliore : refactoriser par petits pas, faire et recevoir une review constructive.

Le fil rouge est la charge cognitive. Lire du code inconnu demande de tenir en tête la syntaxe, l’intention et l’exécution en même temps. Nommer ce qui bloque indique déjà quoi faire. Git te sert de filet : tant que tu commites, tu peux revenir à un état qui marchait.

Sections

1. Lire du code
2. Code smells
3. Refactoriser
4. Préparer et recevoir une review
5. Faire une revue de code constructive
6. Domain-Driven Design
7. Annexes
8. Catégories des variables
9. Vocabulaire
10. Principes et méthodos