ExplainCommandInstruction.md

Challenge instructions for /explain command

Version française disponible plus bas

Step 1: On the main file

Instructions

1. Open the game.cpp file.
2. Press alt + :.
3. Type /explain and press enter.

Observations

To notice:

1. Copilot described the entire class.
2. You can have access to the references used in the input prompt. Notice that only the open file was used.
3. Check the explanations and see if they fit with the code you are reading.

Step 2: On multiple files

Instructions

Open a new chat.

You can ask Copilot to take further files into account using # inside the chat.

Observations

To notice:

1. This time only the specified file was taken into account.
2. Compare the result with the previous answer which used only game.cpp.

Step 3: On code section exclusively

Instructions

Open a new chat.

1. Open the file grid.cpp.
2. Select the line 12 containing a lambda expression.
3. Press alt + : and enter /explain followed by # and click on the option 'Grid.cpp':12 to only consider line 12.

Observations

Redo the same experience, this time only using the command /explain and compare the results.

Make the same steps on IsFull, which is a more complicated expression.

Instructions en français

Étape 1 : Sur le fichier principal

Instructions

1. Ouvrez le fichier game.cpp.
2. Appuyez sur alt + :.
3. Tapez /explain et appuyez sur Entrée.

Observations

À noter :

1. Copilot a décrit toute la classe.
2. Vous pouvez accéder aux références utilisées dans l'invite de saisie. Remarquez que seul le fichier ouvert a été utilisé.
3. Vérifiez les explications et voyez si elles correspondent au code que vous lisez.

Étape 2 : Sur plusieurs fichiers

Instructions

Ouvrez un nouveau chat.

Vous pouvez demander à Copilot de prendre en compte d'autres fichiers en utilisant # dans le chat.

Observations

À noter :

1. Cette fois, seul le fichier spécifié a été pris en compte.
2. Comparez le résultat avec la réponse précédente qui n'utilisait que game.cpp.

Étape 3 : Sur une section de code exclusivement

Instructions

Ouvrez un nouveau chat.

1. Ouvrez le fichier grid.cpp.
2. Sélectionnez la ligne 12 contenant une expression lambda.
3. Appuyez sur alt + : et entrez /explain suivi de # et cliquez sur l'option 'Grid.cpp':12 pour ne considérer que la ligne 12.

Observations

Refaites la même expérience, cette fois en utilisant uniquement la commande /explain et comparez les résultats.

Faites les mêmes étapes sur IsFull, qui est une expression plus compliquée.