Ouvrir et décrire une PR

Tu as écrit le changement, lancé les tests, et le diff a l'air propre. Maintenant il faut ouvrir une PR — mais un titre vide comme "fix bug" ne laisse rien au reviewer pour commencer. Une bonne description de PR ne répète pas ce que le diff montre déjà — elle explique le "pourquoi" : ce qui a déclen

Une bonne description, c'est comme une note qu'on laisse à une babysitter : écrire 'surveille l'enfant' ne suffit pas — il faut expliquer pourquoi la routine est différente ce soir et comment vérifier que tout va bien avant le coucher.

description de PR (PR description): Le texte qui accompagne la Pull Request et explique au reviewer pourquoi le changement a été fait, comment le tester et quel est le risque — pas seulement une reformulation de ce que le diff montre déjà.
modèle de PR (PR template): Un fichier standard dans le repo (par exemple .github/pull_request_template.md) qui fixe quelles sections doivent apparaître dans chaque description de PR, pour que tout le monde remplisse la même information.
PR en statut brouillon (Draft PR): Une PR ouverte en mode brouillon — visible par l'équipe et qui lance les vérifications, mais ne signale pas 'prête pour une revue complète' tant qu'elle n'est pas marquée Ready for review.
prête pour la revue (Ready for review): L'action qui fait passer une PR de brouillon à un état qui demande activement toute l'attention d'un reviewer — le signal que le travail est prêt, pas seulement visible.