Obtenir des commentaires sur votre code à partir de GitHub Copilot

À propos du codage collaboratif

Lorsque vous travaillez avec d’autres personnes sur GitHub, vous apportez généralement vos modifications dans une branche ou un fork du projet principal, puis vous les envoyez en tant que pull request. Une pull request affiche les différences entre le code d'origine et vos modifications, et invite le mainteneur du dépôt à fusionner votre code avec le projet.

Obtenir des retours sur votre pull request des autres est une partie importante du processus de développement logiciel. Les revues de pull requests améliorent le code particulier sur lequel vous travaillez, tout en améliorant vos compétences de codage et de collaboration au fil du temps. Parfois, surtout lorsque vous apprenez à coder, vous n’avez pas toujours quelqu’un à qui demander des retours. Dans ces cas, vous pouvez à la place obtenir des commentaires et tous leurs avantages de GitHub Copilot.

Un pull request est un espace collaboratif où vous pouvez montrer aux autres les modifications que vous proposez et obtenir un retour d'information. Lorsque vous demandez une révision par Copilot, vous apprendrez le même processus que celui que vous utiliserez lorsque vous travaillerez avec des équipes de développement. La seule différence est que vous allez également demander des révisions de collègues humains en parallèle avec Copilot.

Remarque

          révision du code Copilot sur le GitHub site web est une fonctionnalité premium, disponible avec les Copilot Pro, Copilot Pro+, Copilot Business et Copilot Entreprise plans. Pour plus d’informations sur la manière dont l’utilisation de révision du code Copilot affecte vos quotas, consultez [AUTOTITLE](/copilot/concepts/agents/code-review#code-review-monthly-quota). Si vous êtes étudiant, vous pourrez peut-être accéder Copilotgratuitement aux fonctionnalités Premium, voir [AUTOTITLE](/copilot/how-tos/copilot-on-github/set-up-copilot/enable-copilot/set-up-for-students).

1. Création du référentiel de pratique

Dans cet exercice, vous allez utiliser un exemple de référentiel contenant du code existant. L’exemple de référentiel est new2code/grid-toy, un petit projet HTML et JavaScript qui affiche une grille de carrés changeant de couleur. Il s’agit d’un GitHub Pages site et vous pouvez afficher la version d’origine à l’adresse https://new2code.github.io/grid-toy.

Commencez par créer votre propre copie du référentiel grid-toy.

Accédez à la nouvelle page du référentiel. En suivant ce lien, vous présélectionnerez le modèle sur le compte new2code.
Sous « Propriétaire », sélectionnez votre compte d’utilisateur.
Dans le champ « Nom du référentiel », tapez « grid-toy ».
Cliquez sur Créer un dépôt.

2. Apporter une modification

Ensuite, vous allez apporter une modification au fichier JavaScript.

Dans votre nouveau référentiel, cliquez sur script.js dans la liste des fichiers.
Pour modifier le fichier JavaScript, en haut à droite, cliquez sur .
À la ligne 25, ajoutez le code suivant :
JavaScript
```
if (Math.random() < INVERT_PROBABILITY) {
   cell.classes.add("black");
}
```
```
if (Math.random() < INVERT_PROBABILITY) {
   cell.classes.add("black");
}
```
Cette modification définit de manière aléatoire certains carrés de la grille en noir lors du chargement de la page. Il y a une erreur délibérée avec GitHub Copilot pour déclencher des commentaires : la propriété correcte est en fait .classList et non .classes. GitHub Copilot devrait nous aider à résoudre ce problème.
Pour commiter la modification, en haut à droite, cliquez sur Commiter les modifications...
Dans le champ « Message de validation », saisissez une mention telle que « Définir des carrés de manière aléatoire au chargement ».
Sélectionnez Créer une nouvelle branche pour ce commit et démarrer une pull request.
Cliquez sur Proposer des modifications.

3. Créer une pull request et demander une révision

Complétez maintenant la pull request et demandez une révision.

Saisissez un titre et, si vous le souhaitez, une description pour votre demande de tirage.
Cliquez sur Réviseurs.
- Si Copilot apparaît dans la liste suggérée, cliquez sur « Copilot ».
- Si ce n’est pas le cas, commencez à taper « Copilot », puis cliquez sur le résultat.
Cliquez sur Créer une requête d'extraction.

Vous serez dirigé vers votre nouvelle pull request.

4. Appliquer une modification suggérée

Dans quelques minutes, GitHub Copilot examinera votre pull request, produira un résumé et créera des modifications proposées pour tous les problèmes détectés.

Attendez que la révision de GitHub Copilot apparaisse.
L’une de ces suggestions devrait corriger l’erreur volontaire introduite précédemment en remplaçant .classes par .classList. Sous la suggestion de modification, cliquez sur Commiter la suggestion.
Cliquez sur Commiter les changements.
Il est possible que GitHub Copilot ait trouvé d'autres améliorations et ait laissé des commentaires supplémentaires. Si vous comprenez les modifications suggérées, vous pouvez également les appliquer.

5. Fusion

Une fois que vous êtes satisfait des modifications, vous pouvez fusionner la pull request. Les modifications de votre branche sont alors ajoutées à la branche par défaut du référentiel (main).

Au bas de la page, cliquez sur Fusionner la pull request.
Vous pouvez également mettre à jour le message de commit.
Appuyez sur Confirmer la fusion.

Étapes suivantes

Le projet peut être publié à l’aide de GitHub Pages. Maintenant que vous avez apporté quelques modifications, vous pouvez publier votre version du référentiel pour la voir en action. Consultez « Configuration d’une source de publication pour votre site GitHub Pages ».