Utilisation de GitHub Codespaces pour les requêtes de tirage

Vous pouvez utiliser GitHub Codespaces dans votre navigateur web ou dans Visual Studio Code pour créer des demandes de tirage, passer en revue les demandes de tirage et traiter les commentaires de révision.

Dans cet article

L'utilisation d'un codespace pour travailler sur une pull request vous offre tous les avantages de GitHub Codespaces. Pour plus d’informations, consultez « AUTOTITLE ».

À propos des pull requests dans GitHub Codespaces

GitHub Codespaces vous offre un grand nombre de fonctionnalités dont vous pourriez avoir besoin pour travailler avec les pull requests :

  • Créer une demande de tirage (pull request) – À l'aide des commandes Terminal et Git ou de l'affichage « Contrôle de code source », vous pouvez créer des demandes de tirage (pull request) comme vous le feriez sur GitHub. Si le référentiel utilise un modèle de requête de tirage, vous pourrez l'utiliser dans la vue « Gestion de code source ».
  • Ouvrir une demande de tirage – Vous pouvez ouvrir une demande de tirage existante dans un espace de code, à condition d'avoir accès à la branche qui est fusionnée.
  •         [Review a pull request](#reviewing-a-pull-request-in-codespaces) : une fois que vous avez ouvert une demande de tirage dans un espace de code, vous pouvez utiliser la vue « GitHub Pull Request » pour ajouter des commentaires de révision et approuver des demandes de tirage. Vous pouvez également utiliser GitHub Codespaces pour afficher les commentaires de révision.

Ouverture d'une pull request dans Codespaces

  1. Sous le nom de votre référentiel, cliquez sur Demandes de tirage.

    Capture d’écran de la page principale d’un dépôt. Dans la barre de navigation horizontale, un onglet intitulé « Demandes de tirage » est indiqué en orange foncé.

  2. Dans la liste des pull requests, cliquez sur la pull request que vous souhaitez ouvrir dans Codespaces.

  3. Sur le côté droit de votre écran, cliquez sur Code.

  4. Sous l'onglet Codespaces, cliquez sur .

    Capture d'écran de la liste déroulante « Code » avec l'onglet « Codespaces » sélectionné. Le message « Aucun codespace » s'affiche. Le bouton Plus est mis en surbrillance.

    Un codespace est créé pour la branche de pull request et s'ouvre dans votre éditeur par défaut pour GitHub Codespaces.

Révision d'une pull request dans Codespaces

  1. Avec votre éditeur par défaut défini sur Visual Studio Code ou Visual Studio Code pour le web, ouvrez la pull request dans un codespace, comme expliqué plus tôt dans cet article dans la section "Ouverture d'une pull request dans Codespaces".

  2. Dans la barre d'activité, cliquez sur l'icône de pull request Git pour afficher la barre latérale « Pull Request GitHub ». Cette icône s'affiche uniquement dans l'Activity Bar lorsque vous ouvrez une pull request dans un codespace.

    Capture d'écran de la barre d'activité VS Code. Le pointeur de la souris se trouve au-dessus d'une icône affichant l'infobulle « GitHub Pull Request ».

    Si vous avez ouvert une demande de tirage dans un codespace et que l'icône de demande de tirage n'est pas affichée dans la barre d'activité, vérifiez que vous êtes connecté à GitHub. Cliquez sur l'icône GitHub dans la barre d'activité, puis sur Se connecter.

    Capture d'écran de la barre latérale GitHub montrant le bouton « Se connecter ». L'icône GitHub dans la barre d'activité est mise en évidence avec un encadré orange.

  3. Pour passer en revue les modifications apportées à un fichier spécifique, cliquez sur le nom du fichier dans la barre latérale « Pull Request GitHub ».

    Capture d'écran de la barre latérale de la « Pull Request GitHub ». Un nom de fichier est mis en évidence avec un encadré orange foncé.

    Cela affiche une vue des différences dans l'éditeur, avec la version du fichier de la branche de base à gauche et la nouvelle version du fichier, à partir de la branche principale de la pull request, à droite.

  4. Pour ajouter un commentaire de révision, cliquez sur le signe en regard du numéro de ligne dans le fichier affiché à droite de l'éditeur.

    Capture d'écran de la vue des différences. Dans la version principale du fichier, à droite de l'éditeur, le signe Plus en regard d'une ligne est mis en évidence.

  5. Tapez votre commentaire de revue, puis cliquez sur Démarrer la revue.

    Capture d'écran d'un commentaire en cours d'ajout, indiquant « Oui, je suis d'accord, c'est plus clair ». Le bouton « Démarrer la révision » s'affiche sous le commentaire.

  6. Si vous le souhaitez, vous pouvez suggérer une modification que l'auteur de la demande de tirage (pull request) peut cliquer pour valider s'il est d'accord avec votre suggestion. Pour ce faire, cliquez et maintenez le + signe à côté de la première ligne que vous souhaitez suggérer de modifier, puis faites glisser le + signe vers la dernière ligne que vous souhaitez suggérer de modifier. Cliquez ensuite sur Créer une suggestion dans la zone de commentaire qui s'affiche.

    Les lignes que vous avez sélectionnées sont copiées dans la zone de commentaire, où vous pouvez les modifier pour suggérer une modification. Vous pouvez ajouter un commentaire au-dessus de la ligne qui contient ```suggestion pour expliquer votre modification suggérée.

    Cliquez sur Ajouter un commentaire pour ajouter votre suggestion à la demande de tirage (pull request).

    Capture d'écran d'une modification suggérée. Les boutons « Faire une suggestion » et « Ajouter un commentaire » sont affichés sous la modification suggérée.

  7. Lorsque vous avez terminé d'ajouter des commentaires de révision, vous pouvez ajouter un commentaire récapitulatif pour votre revue de pull request dans la barre latérale « Pull Request GitHub ». Vous pouvez ensuite cliquer sur Commenter et envoyer, ou sur la flèche déroulante et sélectionner Approuver et envoyer ou Demander des modifications et envoyer.

    Capture d'écran de la barre latérale montrant les options de liste déroulante « Commenter et envoyer », « Approuver et envoyer » et « Demander des modifications et envoyer ».

Pour plus d’informations sur l’examen d’une requête de tirage, consultez AUTOTITLE.

Afficher les commentaires d'une révision dans Codespaces

Une fois que vous avez reçu des commentaires sur une pull request, vous pouvez l'ouvrir dans un codespace via votre navigateur web ou dans VS Code pour voir les commentaires de révision. À partir de là, vous pouvez répondre aux commentaires, ajouter des réactions ou ignorer la révision.