À propos des commentaires sur une demande de tirage
Vous pouvez commenter dans l’onglet Conversation d’une pull request afin de laisser des commentaires généraux, de poser des questions ou d’exprimer des félicitations. Vous pouvez également suggérer des modifications que l’auteur de la pull request peut appliquer directement depuis votre commentaire.
Vous pouvez également commenter des fichiers ou des sections spécifiques d’un fichier dans l’onglet Fichiers modifiés d’une demande de tirage sous forme de commentaires de ligne ou de fichier individuels, ou dans le cadre d’une révision de demande de tirage. L’ajout de commentaires de ligne ou de fichier est un excellent moyen de discuter des questions sur l’implémentation ou de donner des commentaires à l’auteur. Consultez « Revues de demande de tirage ».
Consultez « Révision des changements proposés dans une demande de tirage ».
Remarque
Si vous répondez à une pull request par e-mail, votre commentaire est ajouté sous l’onglet Conversation et ne fait pas partie d’une révision de pull request.
Pour répondre à un commentaire de ligne ou de fichier existant, accédez au commentaire sous l’onglet Conversation ou Fichiers modifiés . Ensuite, ajoutez un autre commentaire ci-dessous.
Conseil
- Les commentaires des pull requests prennent en charge la même mise en forme que les commentaires réguliers sur GitHub, tels que @mentions, les emojis et les références.
- Vous pouvez ajouter des réactions aux commentaires des demandes de tirage sous l’onglet Fichiers modifiés.
Ajout de commentaires à une pull request
-
Sous le nom de votre référentiel, cliquez sur Demandes de tirage.
-
Dans la liste des pull requests, cliquez sur la pull request sur laquelle vous souhaitez ajouter des commentaires sur une ligne.
-
Sur la requête de tirage, cliquez sur Fichiers modifiés.
-
Pointez sur la ligne de code dans laquelle vous souhaitez ajouter un commentaire, puis cliquez sur l’icône de commentaire bleue.
-
Si vous le souhaitez, vous pouvez ajouter un commentaire sur plusieurs lignes. Pour sélectionner une plage de lignes, cliquez sur le numéro de ligne de la première ligne sur laquelle vous souhaitez commenter, puis faites glisser vers le bas vers la ligne finale, ou maintenez la touche Maj enfoncée , puis cliquez sur le dernier numéro de ligne. Vous pouvez ensuite cliquer sur l’icône de commentaire bleu sur la dernière ligne sur laquelle vous souhaitez commenter. Vous pouvez également cliquer sur l’icône de commentaire bleue en regard de la première ligne sur laquelle vous souhaitez commenter, puis faire glisser vers le bas jusqu’à la dernière ligne sur laquelle vous souhaitez commenter.
-
Entrez votre commentaire dans le champ de commentaire.
-
Si vous voulez suggérer un changement spécifique pour une ou plusieurs lignes, cliquez sur , puis modifiez le texte dans le bloc de suggestion.
-
Pour commenter directement un fichier, à droite du fichier, cliquez sur et tapez votre commentaire.
-
Lorsque vous avez terminé :
-
Si vous souhaitez uniquement ajouter un seul commentaire, cliquez sur Ajouter un commentaire unique.
-
Si vous souhaitez ajouter plusieurs commentaires, cliquez sur Commencer une révision, puis ajoutez des commentaires.
Lorsque vous avez terminé, cliquez sur Terminer votre révision, laissez un résumé de votre révision, puis cliquez sur Envoyer une révision.
-
Toute personne consultant la pull request ou le référentiel sera informée de vos commentaires. Le traitement par lots de vos commentaires évite d’envoyer plusieurs notifications.
Si vous commentez sur une demande de tirage créée par Copilot, le traitement par lots de vos commentaires empêche Copilot de commencer à travailler sur des commentaires individuels avant d’avoir terminé votre révision. Voir Démarrage des sessions GitHub Copilot.
Résolution des conversations
Vous pouvez résoudre une conversation dans une demande de tirage si vous avez ouverte celle-ci ou si vous avez un accès en écriture au dépôt où la demande de tirage a été ouverte.
Pour indiquer qu’une conversation sous l’onglet Fichiers modifiés est terminée, cliquez sur Résoudre la conversation.
Toute la conversation sera réduite et marquée comme résolue. Cela facilite la recherche de conversations qui doivent toujours être traitées.
Si la suggestion dans un commentaire sort du cadre de votre demande de tirage, vous pouvez ouvrir un nouveau problème qui suit les commentaires et renvoie au commentaire d’origine. Consultez « Création d’un problème ».
Découverte et navigation dans les conversations
Vous pouvez découvrir et accéder à toutes les conversations de votre demande de tirage avec le menu Conversations sous l’onglet Fichiers modifiés .
Dans cette vue, vous pouvez voir quelles conversations sont non résolues, résolues et obsolètes. Cela facilite la découverte et la résolution des conversations.
