Merge pull request #47247 from lootle1/MR32

Technical Review 996543: Using advanced GitHub Copilot features

Author: v-dirichards

learn-pr/github/advanced-github-copilot/1-introduction.yml

@@ -6,7 +6,7 @@ metadata:
   description: GitHub Copilot is an AI pair programmer that offers autocomplete-style suggestions as you code in your text editor. You can use natural language to describe what you need, or ask GitHub Copilot interactive questions about coding and get meaningful answers.
   author: abrilurena
   ms.author: abrilu
-  ms.date: 5/10/2024
+  ms.date: 09/30/2024
   ms.topic: unit
   ms.collection:
     - ce-advocates-ai-copilot

learn-pr/github/advanced-github-copilot/2-advanced-github-copilot-features.yml

@@ -7,7 +7,7 @@ metadata:
   description: GitHub Copilot is an AI-assisted coding tool that helps developers write better code, faster by generating suggestions using code, comments, and interactive chats.
   author: abrilurena
   ms.author: abrilu
-  ms.date: 5/10/2024
+  ms.date: 09/30/2024
   ms.topic: unit
   ms.collection:
     - ce-advocates-ai-copilot

learn-pr/github/advanced-github-copilot/3-exercise-setup.yml

@@ -6,7 +6,7 @@ metadata:
   description: Enable the GitHub Copilot service and install the extension in Visual Studio Code.
   author: abrilurena
   ms.author: abrilu
-  ms.date: 5/10/2024
+  ms.date: 09/30/2024
   ms.topic: unit
   ms.collection:
     - ce-advocates-ai-copilot

learn-pr/github/advanced-github-copilot/4-applied-copilot-techniques.yml

@@ -8,7 +8,7 @@ metadata:
   description: Use GitHub Copilot to update a Python project. Update the Python API and use GitHub Copilot to suggest additions for new endpoints.
   author: abrilurena
   ms.author: abrilu
-  ms.date: 5/10/2024
+  ms.date: 09/30/2024
   ms.topic: unit
   ms.collection:
     - ce-advocates-ai-copilot

learn-pr/github/advanced-github-copilot/5-exercise-update-a-web-api.yml

@@ -8,7 +8,7 @@ metadata:
   description: Apply suggestions generated by GitHub Copilot to update a Python project using Visual Studio Code
   author: abrilurena
   ms.author: abrilu
-  ms.date: 5/10/2024
+  ms.date: 09/30/2024
   ms.topic: unit
   ms.collection:
     - ce-advocates-ai-copilot

learn-pr/github/advanced-github-copilot/6-knowledge-check.yml

@@ -6,7 +6,7 @@ metadata:
   description: Review advanced features in GitHub Copilot.
   author: abrilurena
   ms.author: abrilu
-  ms.date: 5/10/2024
+  ms.date: 09/30/2024
   ms.topic: unit
   ms.collection:
     - ce-advocates-ai-copilot
@@ -16,7 +16,7 @@ quiz:
   questions:
   - content: "What is ghost text in GitHub Copilot?"
     choices:
-    - content: "Ghost text in GitHub Copilot are suggestions that appears in your text editor as you type."
+    - content: "Ghost text in GitHub Copilot are suggestions that appear in your text editor as you type."
       isCorrect: true
       explanation: "That's correct! Ghost text refers to the suggestions given by GitHub Copilot without a prompt, based on your currently opened files. By accepting these suggestions with the Tab key or manually editing them, you can quickly write code and documentation for your project."
     - content: "Ghost text in GitHub Copilot are options used when typing to provide suggestions."
@@ -29,13 +29,13 @@ quiz:
     choices:
     - content: "Access the inline chat by clicking on the chat icon in the left sidebar of Visual Studio Code."
       isCorrect: false
-      explanation: "Incorrect, although you can use this method to access GitHub Copilot's dedicated chat pane. The inline chat requires a keyboard shortcut (Ctrl+i for Windows or Command+i for mac) to open in your code context."
-    - content: "Use Ctrl+i on Windows or Command+i on a mac to open the inline chat."
+      explanation: "Incorrect, although you can use this method to access GitHub Copilot's dedicated chat pane. The inline chat requires a keyboard shortcut (Ctrl+i for Windows or Command+i for Mac) to open in your code context."
+    - content: "Use Ctrl+i on Windows or Command+i on a Mac to open the inline chat."
       isCorrect: true
       explanation: "That's correct! By using the keyboard combination, you can access GitHub Copilot's inline chat without leaving your code context. This functionality enables efficient interaction with the tool and faster response times during development."  
-    - content: "Access the inline chat by using Alt+i on Windows or Option+i on a mac."
+    - content: "Access the inline chat by using Alt+i on Windows or Option+i on a Mac."
       isCorrect: false
-      explanation: "Incorrect, these aren't the correct keyboard shortcuts. You can access GitHub Copilot's inline chat using Ctrl+i for Windows and Command+i for mac instead."
+      explanation: "Incorrect, these aren't the correct keyboard shortcuts. You can access GitHub Copilot's inline chat using Ctrl+i for Windows and Command+i for Mac instead."
   - content: "What are slash commands used for in GitHub Copilot?"
     choices:
       - content: "Slash commands are used to format your codebase according to best practices."
@@ -46,26 +46,26 @@ quiz:
         explanation: "Incorrect. Although GitHub Copilot may provide suggestions for fixing bugs, slash commands aren't specifically designed for debugging or finding security vulnerabilities in your projects."
       - content: "Slash commands are shortcuts to quickly solve common development tasks within the chat or inline pane."
         isCorrect: true
-        explanation: "That's correct! Slash commands help you perform specific actions like writing tests and documentation faster by using predefined intents. You can access these slash command options in a drop-down menu after typing / in the chat or inline pane."       
+        explanation: "That's correct! Slash commands help you perform specific actions like writing tests and documentation faster by using predefined intents. You can access these slash command options in a drop-down menu after typing `/` in the chat or inline pane."       
   - content: "What are the benefits of using agents like '@terminal' or '@workspace' when interacting with GitHub Copilot?"
     choices:
     - content: "Agents in Visual Studio Code help you ask questions within a specific context, allowing for more precise and relevant answers from GitHub Copilot."
       isCorrect: true
-      explanation: "That's correct! Agents like '@terminal' or '@workspace' allow you to interact with GitHub Copilot in the context of your terminal or entire workspace. By using these agents, questions are more precise and relevant, helping you efficiently solve development tasks."
+      explanation: "That's correct! Agents like '@terminal' or '@workspace' allow you to interact with GitHub Copilot in the context of your terminal or entire workspace. By using these agents, questions are more precise and relevant, which helps you efficiently solve development tasks."
     - content: "Agents help enforce a consistent code format based on best practices within Visual Studio Code for improved readability."
       isCorrect: false
       explanation: "Incorrect, agents don't specifically enforce formatting rules. They're used to interact with GitHub Copilot in the context of your terminal or workspace when asking questions and receiving answers."
     - content: "Agents provide extra security features for detecting vulnerabilities and intrusions within Visual Studio Code projects."
       isCorrect: false
-      explanation: "Incorrect, agents don't specifically focus on providing security features. They're used to interact with GitHub Copilot in a specific context when asking questions related to development tasks."
+      explanation: "Incorrect, agents don't specifically focus on providing security features. They're used to interacting with GitHub Copilot in a specific context when asking questions related to development tasks."
   - content: "What are the benefits of using implicit prompts with slash commands in inline chat for fixing code issues with GitHub Copilot?"
     choices:
     - content: "Implicit prompts help enforce a consistent naming convention and syntax based on best practices within Visual Studio Code projects for improved readability."
       isCorrect: false
       explanation: "Incorrect. Implicit prompts don't specifically focus on enforcing naming conventions or syntax rules. They're used to interact with GitHub Copilot in a way that can provide helpful responses without writing long, explicit prompts when fixing code issues."
     - content: "Implicit prompts help get better responses from GitHub Copilot without writing longer prompts, making it easier to interact and fix code issues."
       isCorrect: true
-      explanation: "That's correct! Implicit prompts with slash commands in inline chat allow you for more straightforward interaction when fixing code. By using features like '/fix', GitHub Copilot can provide helpful responses even without detailed prompting, streamlining the development process."      
+      explanation: "That's correct! Implicit prompts with slash commands in inline chat allow you for more straightforward interaction when fixing code. By using features like '/fix', GitHub Copilot can provide helpful responses even without detailed prompting, which streamlines the development process."      
     - content: "Implicit prompts help detect security vulnerabilities and potential malicious activities within Visual Studio Code projects for increased safety."
       isCorrect: false
       explanation: "Incorrect. Implicit prompts don't specifically focus on providing security features or detecting vulnerabilities in your projects. They're used to streamline interaction with GitHub Copilot when fixing code issues by using implicitly crafted prompts and slash commands."

learn-pr/github/advanced-github-copilot/7-summary.yml

@@ -6,7 +6,7 @@ metadata:
   description: Review what you learned.
   author: abrilurena
   ms.author: abrilu
-  ms.date: 5/10/2024
+  ms.date: 09/30/2024
   ms.topic: unit
   ms.collection:
     - ce-advocates-ai-copilot

learn-pr/github/advanced-github-copilot/includes/1-introduction.md

@@ -9,14 +9,14 @@ GitHub Codespaces is a hosted developer environment operating in the cloud that
 
 As a developer, you want to be more productive typing code faster both for net new projects and existing ones. For this task, you want to use advanced features from an AI assistant that helps improve your developer workflows in code writing, documentation, testing, and more.
 
-In this module, you'll understand how you can use advanced features of GitHub Copilot with applied examples modifying a repository using different techniques to add new HTTP API endpoints, write unit tests, and document existing code.
+In this module, you'll understand how you can use advanced features of GitHub Copilot with applied examples modifying a repository using different techniques to add new HTTP API (Application Programming Interface) endpoints, write unit tests, and document existing code.
 
 ## What will I learn?
 
-By the conclusion of this module, you'll have acquired the skills to:
+By the conclusion of this module, you'll acquire the skills to:
 
 - Work with a preconfigured GitHub repository in Codespaces with the GitHub Copilot extension.
-- Use interactive features of GitHub Copilot to generate useful suggestions for an existing project
+- Use interactive features of GitHub Copilot to generate useful suggestions for an existing project.
 - Apply advanced GitHub Copilot features to learn more about a new project, write documentation, and create unit tests.
 
 ## What is the main objective?
@@ -28,7 +28,7 @@ After successfully finishing this module, you'll be capable of using interactive
 Skills:
 
 - Basic understanding of Python and text editors.
-- Basic comprehension of Git and GitHub Fundamentals and running basic `git` commands like `git add` and `git push`
+- Basic comprehension of Git and GitHub Fundamentals and running basic `git` commands like `git add` and `git push`.
 
 Accounts:
 

learn-pr/github/advanced-github-copilot/includes/2-advanced-github-copilot-features.md

@@ -3,30 +3,30 @@ Often, when you work with code, you need to review the project's documentation i
 
 ## The basics
 
-When GitHub Copilot is enabled, it provides you with suggestions. These suggestions are called ghost text, and you can either ignore the ghost text or accept it by pressing the Tab key. The suggestions don't require a prompt because GitHub Copilot uses by default the files you have open as context. However, you can provide a prompt using a comment, using the chat window, or using the inline chat within your code. 
+When GitHub Copilot is enabled, it provides you with suggestions. These suggestions are called ghost text. You can either ignore the ghost text, or accept it by pressing the **Tab** key. The suggestions don't require a prompt because by default GitHub Copilot uses the files you have open as context. However, you can provide a prompt using a comment, the chat window, or the inline chat within your code.
 
 ## Chatting with GitHub Copilot
 
-GitHub Copilot allows you to have an interactive discussion using the chat feature. In Visual Studio Code, you can click the chat icon on the left sidebar, which will open the chat interface in a dedicate pane. 
+GitHub Copilot allows you to have an interactive discussion using the chat feature. In Visual Studio Code, you can click the chat icon on the left sidebar, which opens the chat interface in a dedicated pane.
 
-In this pane, you can ask questions about the code you're currently working on, or other software-related questions. 
+In this pane, you can ask questions about the code you're currently working on or other software-related questions.
 
 ## Using inline chat
 
-Besides the dedicated chat pane, you can use the inline chat, which allows you to interact with GitHub Copilot without leaving your code.
+Besides the dedicated chat pane, you can use the inline chat. It allows you to interact with GitHub Copilot without leaving your code.
 
-Access the inline chat by using Ctrl+i on Windows or Command+i on a mac. One of the benefits of using the inline chat is that you don't have to switch context by going to a different pane. The suggestions and interactions happen closer to the code.
+Access the inline chat by using **Ctrl+i** on Windows or **Command+i** on a Mac. One of the benefits of using the inline chat is that you don't have to switch context by going to a different pane. The suggestions and interactions happen closer to the code.
 
 ## Slash commands
 
-Within the chat pane or when using the inline chat, you can use slash commands. These commands allow GitHub Copilot to use a specific intent for quickly solving common development tasks. 
+Within the chat pane or when using the inline chat, you can use slash commands. These commands allow GitHub Copilot to use a specific intent for quickly solving common development tasks.
 
-If you type a forward slash in the chat pane or in inline chat, you should see a drop-down menu with all the slash commands available. For example the `/tests` slash command helps you write tests, while the `/docs` command is intended for writing documentation.
+If you type a forward slash in the chat pane or inline chat, you should see a drop-down menu with all the slash commands available. For example, the `/tests` slash command helps you write tests, while the `/docs` command is intended for writing documentation.
 
 Using specific slash commands to create a question is a good way to get better responses without having to write longer prompts.
 
 ## Agents
 
-Visual Studio Code has a feature called "agents" that allows you to interact with GitHub Copilot. These agents allow you to ask questions using a specific context. For example the `@terminal` agent helps you chat with GitHub Copilot to interact with the terminal. 
+Visual Studio Code has a feature called *agents* that allows you to interact with GitHub Copilot. These agents allow you to ask questions using a specific context. For example the `@terminal` agent helps you chat with GitHub Copilot to interact with the terminal.
 
-Another agent is `@workspace` which is aware of your entire workspace, allowing you to ask questions about the entire project. To use an agent, prefix your question with the agent, for example: `@workspace how can I package this project?`.
+Another agent is `@workspace`, which is aware of your entire workspace. It allows you to ask questions about the entire project. To use an agent, prefix your question with the agent, for example: `@workspace how can I package this project?`.

learn-pr/github/advanced-github-copilot/includes/3-exercise-setup.md

@@ -6,8 +6,8 @@ In this exercise, we create a new repository using the GitHub template for a web
 First you need to launch the Codespaces environment, which comes preconfigured with the GitHub Copilot extension.
 
 1. Open the [Codespace with the preconfigured environment](https://codespaces.new/MicrosoftDocs/mslearn-advanced-copilot?azure-portal=true) in your browser.
-1. On the **Create codespace** page, review the codespace configuration settings and then select **Create new codespace**
-1. Wait for the codespace to start. This startup process can take a few minutes.
+1. On the **Create codespace** page, review the Codespace configuration settings, and then select **Create new codespace**.
+1. Wait for the Codespace to start. This startup process can take a few minutes.
 1. The remaining exercises in this project take place in the context of this development container.
 
 > [!IMPORTANT]
@@ -17,15 +17,11 @@ First you need to launch the Codespaces environment, which comes preconfigured w
 
 When complete, Codespaces loads with a terminal section at the bottom. Codespaces installs all the required extensions in your container. Once the package installs are completed, Codespaces will execute the `uvicorn` command to start your web application running within your Codespace.
 
-When the web application has successfully started, a message in the terminal shows that the server is running on port 8000 within your Codespace.
-
-### Testing the API
-
-Try to interact with the API by sending a request using the self-documented page. Select the POST button and then on the Try it Out button:
+When the web application has successfully started, a message in the terminal **Ports** tab shows that the server is running on port 8000 within your Codespace.
 
 ## Sign up for GitHub Copilot
 
 If you haven't already, you need to register by setting up [a free trial or subscription for your account](https://github.com/github-copilot/signup).
 
 >[!Note]
-> Educators, Students and select open-source maintainers can sign up for Copilot for free, learn how at: https://aka.ms/Copilot4Students
+> Educators, Students and select open-source maintainers can sign up for Copilot for free, learn how at [Setting up GitHub Student and GitHub Copilot as an Authenticated Student Developer](https://aka.ms/Copilot4Students).