Nommer
- Fonctions : verbe (
calculer_total,envoyerMail) ; booléens :est_actif,aDesDroits. - Pas de
x,data2,tmp(sauf boucles très courtes). - Conventions :
snake_caseen Python,camelCaseen JS,MAJUSCULESpour les constantes.
Découper
- Une fonction = une responsabilité ; au-delà de ~30 lignes, découper.
- Éviter les imbrications profondes : retours anticipés (
if not ok: return). - Pas de duplication : factoriser.
Commenter
Le pourquoi (contrainte métier, contournement d'un bug) ; docstrings pour les fonctions publiques ; supprimer le code commenté (Git s'en souvient).
Outils
Black / Ruff (Python), Prettier / ESLint (JS), editor.formatOnSave dans VS Code.