Skip to main content
Nous publions des mises à jour fréquentes de notre documentation, et la traduction de cette page peut encore être en cours. Pour obtenir les informations les plus actuelles, consultez la documentation anglaise.

Révision des changements proposés dans une demande de tirage

Dans une demande de tirage (pull request), vous pouvez examiner et discuter des commits, des fichiers modifiés et des différences (ou « diff ») entre les fichiers dans la base et comparer les branches.

À propos de la révision des demandes de tirage

Vous pouvez réviser des changements dans une demande de tirage, fichier par fichier. Quand vous révisez des fichiers dans une demande de tirage, vous pouvez laisser des commentaires individuels sur des changements spécifiques. Une fois que vous avez terminé de réviser un fichier, vous pouvez le marquer comme consulté. Le fichier est alors réduit, ce qui vous permet d’identifier facilement ceux qu’il vous reste à réviser. Une barre de progression située dans l’en-tête de la demande de tirage indique le nombre de fichiers que vous avez consultés. Une fois que vous avez révisé le nombre de fichiers souhaité, vous pouvez approuver la demande de tirage ou demander des changements supplémentaires en envoyant votre révision avec un commentaire récapitulatif.

Astuce : Vous pouvez rechercher une demande de tirage pour laquelle vous, ou une équipe dont vous êtes membre, avez été sollicité pour la révision en utilisant le qualificateur de recherche review-requested:[USERNAME] ou team-review-requested:[TEAMNAME]. Pour plus d’informations, consultez « Recherche de problèmes et de demandes de tirage ».

Démarrage d’une révision

  1. Sous le nom de votre dépôt, cliquez sur Demandes de tirage. Sélection de l’onglet Problèmes et demandes de tirages 1. Dans la liste des demandes de tirage, cliquez sur la demande de tirage que vous voulez réviser. 1. Dans la demande de tirage, cliquez sur Fichiers modifiés. Onglet Fichiers modifiés de la demande de tirage

    Vous pouvez modifier l’aspect de la vue des différences sous cet onglet en cliquant sur et en choisissant la vue unifiée ou fractionnée. Ce choix s’applique quand vous affichez les différences pour d’autres demandes de tirage.

    Paramètres de la vue des différences

    Vous pouvez aussi choisir de masquer les différences d’espaces blancs. Ce choix s’applique uniquement à cette demande de tirage et reste le même pour votre prochaine consultation de cette page.

  2. Filtrez éventuellement les fichiers pour voir uniquement ceux que vous voulez réviser ou utilisez l’arborescence des fichiers pour accéder à un fichier spécifique. Pour plus d’informations, consultez « Filtrage des fichiers dans une demande de tirage ».

  3. Pointez sur la ligne de code dans laquelle vous souhaitez ajouter un commentaire, puis cliquez sur l’icône de commentaire bleue. Pour ajouter un commentaire sur plusieurs lignes, cliquez et faites glisser pour sélectionner la plage de lignes, puis cliquez sur l’icône de commentaire bleue. Icône de commentaire bleue 1. Entrez votre commentaire dans le champ de commentaire. Champ de commentaire 1. 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. Bloc de suggestion

  4. Quand vous avez terminé, cliquez sur Démarrer une révision. Si vous avez déjà démarré une révision, vous pouvez cliquer sur Ajouter un commentaire de révision.

    Bouton Démarrer une révision

Avant de soumettre votre révision, vos commentaires de ligne sont en attente et uniquement visibles par vous. Vous pouvez modifier des commentaires en attente à tout moment avant de soumettre votre révision. Pour annuler une révision en attente, y compris tous ses commentaires en attente, faites défiler la page jusqu’à la fin de la chronologie sous l’onglet Conversation, puis cliquez sur Annuler la révision.

Bouton Annuler la révision

Vous pouvez utiliser GitHub Codespaces pour tester, exécuter et réviser des demandes de tirage.

  1. Ouvrez la demande de tirage (pull request) dans un codespace, comme indiqué dans « Ouverture d’une demande de tirage ».

  2. Dans la barre d’activités, cliquez sur la vue Demande de tirage GitHub. Cette vue s’affiche uniquement quand vous ouvrez une demande de tirage dans un codespace.

    Option d’ouverture d’une demande de tirage dans un espace de code

  3. Pour passer en revue un fichier spécifique, cliquez sur l’icône Ouvrir un fichier dans la barre latérale.

    Option d’ouverture d’une demande de tirage dans un espace de code

  4. Pour ajouter des commentaires de revue, cliquez sur l’icône + en regard du numéro de ligne. Tapez votre commentaire de revue, puis cliquez sur Démarrer la revue.

    Option d’ouverture d’une demande de tirage dans un espace de code

  5. Une fois que vous avez fini d’ajouter des commentaires de revue, dans la barre latérale, vous pouvez choisir d’envoyer les commentaires, d’approuver les changements ou de demander des changements.

    Option d’ouverture d’une demande de tirage dans un espace de code

Pour plus d’informations sur la révision des demandes de tirage dans GitHub Codespaces, consultez « Utilisation de GitHub Codespaces pour les demandes de tirage ».

Révision des changements de dépendances

Si la demande de tirage contient des changements apportés aux dépendances, vous pouvez utiliser la révision des dépendances d’un fichier manifeste ou d’un fichier de verrouillage pour voir ce qui a changé et vérifier si les changements introduisent des vulnérabilités de sécurité. Pour plus d’informations, consultez « Révision des changements de dépendances dans une demande de tirage ».

  1. Dans la demande de tirage, cliquez sur Fichiers modifiés. Onglet Fichiers modifiés de la demande de tirage

  2. À droite de l’en-tête d’un fichier manifeste ou d’un fichier de verrouillage, affichez la révision des dépendances en cliquant sur le bouton des différences enrichies .

    Bouton des différences enrichies

  3. Vous pouvez également examiner le diff source, car il peut y avoir des changements dans le manifeste ou le fichier de verrouillage qui ne modifient pas les dépendances, ou il peut y avoir des dépendances que GitHub ne peut pas analyser et qui, par conséquent, n’apparaissent pas dans l’examen des dépendances.

    Pour revenir à la vue du diff source, cliquez sur le bouton .

    Bouton du diff source

Marquage d’un fichier comme consulté

Une fois que vous avez terminé de réviser un fichier, vous pouvez le marquer comme consulté. Il est alors réduit. Si le fichier change après que vous l’avez consulté, son marquage comme consulté est annulé.

  1. Dans la demande de tirage, cliquez sur Fichiers modifiés. Onglet Fichiers modifiés de la demande de tirage

  2. À droite de l’en-tête du fichier que vous avez terminé de réviser, sélectionnez Consulté.

    Case à cocher Consulté

Soumission de votre révision

Une fois que vous avez terminé de réviser tous les fichiers souhaités dans la demande de tirage, soumettez votre révision.

  1. Dans la demande de tirage, cliquez sur Fichiers modifiés. Onglet Fichiers modifiés de la demande de tirage 1. Au-dessus du code modifié, cliquez sur Vérifier les modifications. Bouton Vérifier les modifications 1. Tapez un commentaire résumant vos commentaires sur les modifications proposées. Fenêtre Réviser le commentaire récapitulatif

  2. Sélectionnez le type de révision que vous voulez laisser :

    Cases d’option avec des options de révision

    • Sélectionnez Commenter pour laisser des commentaires généraux sans approuver explicitement les changements ni demander des changements supplémentaires.
    • Sélectionnez Approuver pour soumettre vos commentaires et approuver la fusion des changements proposés dans la demande de tirage.
    • Sélectionnez Demander des changements pour soumettre des commentaires à traiter avant de pouvoir fusionner la demande de tirage.
  3. Cliquez sur Envoyer la révision.

Conseils :

  • Si les révisions requises sont activées et qu’un collaborateur avec un accès en écriture, administrateur ou propriétaire au dépôt envoie une révision demandant des modifications, la demande de tirage ne peut pas être fusionnée tant que le même collaborateur n’a pas soumis une autre révision qui approuve les modifications dans la demande de tirage.
  • Les propriétaires et administrateurs du dépôt peuvent fusionner une demande de tirage, même si celle-ci n’a pas reçu de révision d’approbation, ou si un réviseur qui a demandé des modifications a quitté l’organisation ou n’est pas disponible.
  • Si les révisions requises et l’abandon des révisions obsolètes sont activés et qu’un commit de modification du code est poussé vers la branche d’une demande de tirage approuvée, l’approbation est rejetée. La demande de tirage doit être de nouveau révisée et approuvée avant de pouvoir être fusionnée.
  • Lorsque plusieurs demandes de tirage ouvertes ont chacune une branche de tête (head) pointant vers le même commit, vous ne pouvez pas les fusionner si une ou les deux ont une révision en attente ou rejetée.
  • Si votre dépôt demande l’approbation des révisions des personnes avec des autorisations d’écriture ou d’administrateur, toutes les approbations des personnes avec ces autorisations sont marquées d’une coche verte, tandis que les approbations des personnes sans ces autorisations sont marquées d’une coche grise. Les approbations avec une coche grise n’affectent pas si la demande de tirage peut être fusionnée ou non.
  • Les auteurs de demandes de tirage ne peuvent pas approuver leurs propres demandes de tirage.

Pour aller plus loin