1. Des noms qui disent l'intention
Un « 7 » nu au milieu du code ne dit rien : , durée, compteur ? Une constante nommée en tête de fichier — BROCHE__VERTE — dit tout, et se relit dans six mois sans effort. Le bénéfice caché est encore plus grand : le jour où le câblage change, on corrige UNE ligne en haut du fichier, et chaque usage suit automatiquement. Un nombre nu recopié cinq fois, c'est cinq corrections… et quatre oublis possibles.
Même remède pour la boucle : découpe-la en courtes nommées par intention — « allumerVert », « passerAuRouge », « lireBouton ». Chaque fonction fait UNE chose, et son nom dit POURQUOI elle existe, pas comment. () devient alors une table des matières : trois lignes qui racontent l'histoire du , lisibles par n'importe qui — futur toi compris.