Les revues de pull request permettent aux équipes de détecter les problèmes tôt et de maintenir une qualité de code élevée. Ce guide de démarrage rapide vous guide tout au long de chacun des principaux outils d’une révision :
- Commentaire sur le code
- Suggérer des modifications spécifiques
- Soumettre votre révision et approuver ou demander des modifications
Commentaires sur les modifications
Toute personne disposant d’un accès en lecture à un référentiel peut passer en revue et commenter une demande de tirage.
- Dans GitHub, accédez à la pull request.
- Lisez le résumé de la demande de tirage (pull request) et tous les commentaires ou problèmes pertinents pour générer le contexte de révision.
- Cliquez sur l’onglet Fichiers modifiés.
- Pointez sur la ligne sur laquelle vous souhaitez commenter, puis cliquez sur . Pour commenter plusieurs lignes, cliquez et faites-les glisser pour les sélectionner.
- Tapez votre commentaire, puis cliquez sur Commencer une révision pour l’enregistrer comme étant en attente jusqu’à ce que vous ayez terminé la révision. Les commentaires en attente ne sont visibles que pour vous jusqu’à ce que vous envoyiez la révision.
Faire des suggestions de code
Lorsque vous connaissez la modification exacte que vous souhaitez, suggèrez-le afin que l’auteur puisse l’appliquer en un clic.
- Sous l’onglet Fichiers modifiés , démarrez un commentaire sur la ligne ou les lignes à modifier.
- Dans la barre d’outils des commentaires, cliquez pour insérer un bloc de suggestions, puis modifiez le code à l’intérieur de celui-ci pour afficher votre modification proposée.
- Cliquez sur Démarrer une révision ou ajouter un commentaire de révision pour inclure la suggestion dans votre révision.
Soumettre votre révision
Terminez en soumettant votre révision avec une décision qui indique à l’auteur ce qu’il faut faire ensuite.
-
Cliquez sur Vérifier les modifications.
-
Ajoutez un commentaire résumé.
-
Sélectionnez une décision, puis cliquez sur Envoyer la révision :
- Le commentaire laisse des commentaires sans approuver ou demander explicitement des modifications.
- Approuver indique que les modifications sont prêtes à être fusionnées.
- Demander des changements indique les retours que l’auteur doit traiter avant la fusion.