---
title: Commenter les PRs
description: Un guide sur la participation aux discussions sur les Pull Request.
---

Veuillez vous abstenir d'utiliser la boîte générale **Ajouter un commentaire** dans les PRs GitHub lorsque vous laissez un commentaire ou effectuez une évaluation.

![Ne pas utiliser la boîte générale "Ajouter un commentaire" dans GitHub](../assets/img/meta/pr-avoid-general-comments.png)

Les commentaires laissés de la sorte ne sont pas _threaded_, ce qui rend difficile le suivi de plusieurs conversations.

Les commentaires laissés de la manière décrite ci-dessous seront accompagnés d'une boîte de réponse intégrée afin de maintenir les conversations dans un seul et même fil. Ces commentaires peuvent également être marqués comme résolus par la suite, ce qui permet de suivre la discussion plus facilement.

![Capture d'écran d'un commentaire sur GitHub qui comporte une boîte de réponse intégrée, surlignée en orange](../assets/img/meta/pr-threaded-comment.png)

## Commentaire

Pour lancer un fil de commentaires, vous devez laisser tous les commentaires sous l'onglet :octicons-file-diff-16: **Files changed** dans un PR.

![Capture d'écran des onglets pour une pull request. L'onglet "Fichiers modifiés" est souligné en orange foncé.](https://docs.github.com/assets/cb-23571/mw-1440/images/help/pull_requests/pull-request-tabs-changed-files.webp)

Pour laisser un commentaire _général_ sur un PR, cliquez sur l'icône :octicons-comment-16: à droite d'un fichier :

Capture d'écran d'un fichier image sur la page "Files changed" d'une pull request. À droite du fichier, une icône de commentaire est soulignée en orange.](https://docs.github.com/assets/cb-73771/mw-1440/images/help/pull_requests/pull-request-comment-on-file.webp)

Si plusieurs fichiers ont été modifiés dans le PR, commentez le fichier principal ou le plus pertinent qui a été modifié, ou commentez le premier fichier si vous n'arrivez pas à vous décider.

Pour laisser un commentaire _sur une ligne spécifique_ d'un RP, survolez la ligne où vous souhaitez ajouter un commentaire et cliquez sur l'icône bleue de commentaire :

![Capture d'écran d'un diff dans une pull request. A côté d'un numéro de ligne, une icône plus bleue est mise en évidence avec un contour orange.](https://docs.github.com/assets/cb-44227/mw-1440/images/help/commits/hover-comment-icon.webp)

(En option, vous pouvez ajouter un commentaire sur plusieurs lignes. Vous pouvez cliquer sur le numéro de la première ligne que vous souhaitez commenter et faire glisser vers le bas pour sélectionner une série de lignes, puis cliquer sur l'icône bleue de commentaire sur la dernière ligne que vous souhaitez commenter. Vous pouvez également cliquer sur l'icône bleue de commentaire à côté de la première ligne que vous souhaitez commenter, puis faire glisser vers le bas jusqu'à la dernière ligne que vous souhaitez commenter.)

Ensuite, tapez votre commentaire et cliquez sur **Ajouter un seul commentaire**.

## Révision

Pour effectuer une révision, suivez les mêmes étapes que ci-dessus, mais cliquez sur **Démarrer une révision** (et ensuite, **Ajouter un commentaire de révision**) au lieu de **Ajouter un commentaire unique**.

Ensuite, cliquez sur le bouton vert **Finish your review** en haut de la page.

Ne laissez pas de commentaires de discussion dans la case _Laisser un commentaire_ de la fenêtre contextuelle de finalisation de l'examen. Vous pouvez ne rien indiquer ou laisser une brève note si cela ne nécessite pas de suivi. Pour commenter quelque chose qui nécessitera une discussion plus approfondie, ajoutez un commentaire sur un fichier comme décrit ci-dessus.

Cliquez ensuite sur **Submit review**.
