Avant de terminer une tâche (5-15 min max)
- Ajouter un commentaire expliquant une décision non évidente ou un « pourquoi » dans le code complexe.
- Clarifier ou améliorer un message d’erreur
- Extraire un nombre magique dans une constante nommée
- Typer les paramètres et le retour de fonctions, en particulier avec des langages faiblement typés
- Ajouter une trace qui accélèrerait le débogage futur
- Corriger un test défectueux si vous en repérez un
- Mettre à jour le
READMEavec quelque chose qui vous a dérouté - Extraire la logique répétée dans un module partagé/réutilisable
- Documenter avec des exemples ou des cas d’erreur vos API/fonctions
- Documenter une erreur de déploiement ou de configuration
Les 5 questions à se poser
- Qu’est-ce qui m’a troublé en travaillant sur ce projet ?
- Qu’est-ce qui embrouillera la prochaine personne ?
- Qu’est-ce qui n’était pas évident ou surprenant ?
- Qu’est-ce qui faciliterait le débogage ?
- Quel est le modèle que je répète et qui pourrait être extrait ?
La règle
- 5 min minimum, 15 min maximum.
- Si vous avez besoin de plus, créez un ticket — ne l’ignorez pas complètement.
Suivez-moi !
Merci d’avoir lu cet article. Assurez-vous de me suivre sur X, de vous abonner à ma publication Substack et d’ajouter mon blog à vos favoris pour ne pas manquer les prochains articles.
Photo de Pixabay.