Clean Code

Nommage, fonctions courtes, gestion des exceptions, code review — les habitudes qui rendent un code lisible par quelqu'un d'autre que son auteur.

Le code est lu bien plus souvent qu’il n’est écrit. Ces fiches couvrent les habitudes concrètes — pas des règles de style arbitraires — qui déterminent si un code reste compréhensible six mois plus tard, par quelqu’un qui n’est pas vous.

Clean Code Bien nommer ses variables et fonctions Un nom de variable ou de fonction porte une information : pourquoi ça existe, ce que ça fait, comment s'en servir. Un mauvais nom oblige le lecteur à ouvrir le code pour comprendre ce qu'un bon nom lui aurait dit directement. Débutant · 4 min Clean Code Écrire des fonctions courtes et lisibles Une fonction longue n'est pas un problème de longueur : c'est un symptôme qu'elle mélange plusieurs intentions à des niveaux d'abstraction différents. La découper par intention rend le scénario principal lisible comme un sommaire. Intermédiaire · 4 min Clean Code Gérer proprement les exceptions Une exception bien gérée porte un nom qui dit ce qui s'est passé, ne disparaît jamais silencieusement dans un catch vide, et se traduit en réponse utilisateur à un seul endroit — pas dans chaque contrôleur. Intermédiaire · 4 min Clean Code La checklist d'une bonne code review Une code review efficace ne cherche pas la perfection : elle vérifie que le code est plus compréhensible qu'avant, à travers une grille de lecture répétable plutôt qu'une impression au fil de la lecture. Intermédiaire · 3 min