Test run and review (#6)

Author: chriswblake

.github/steps/1-preparing.md

@@ -13,17 +13,18 @@ GitHub Copilot has been proven to increase developer productivity and accelerate
 Your most common interactions will likely be:
 
 - **Inline suggestions**: As you type, Copilot uses the nearby context to suggest code directly in your editor. This will be a familiar interaction if you have used code completion tools like [Intellisense](https://code.visualstudio.com/docs/editor/intellisense), except that the completions may be entire functions.
-- **Copilot Chat**: A dedicated chat panel that lets you ask coding-related questions. This will be familiar if you have used only AI assistant chats. The big difference however, is that your files can provide automatic context for copilot to provide tailored responses.
+- **Copilot Chat**: A dedicated chat panel that lets you ask coding related questions. This will feel familiar if you have used online AI assistant chats. The big difference however, is that your project files will provide automatic context to provide tailored responses.
+- **Copilot Edits**: Similar to Copilot Chat, but less conversational and more big picture or goal oriented.
 
 > [!TIP]
 > You can learn more about current and preview features in the [GitHub Copilot Features](https://docs.github.com/en/copilot/about-github-copilot/github-copilot-features) documentation.
 
 > [!TIP]
-> You can also select different [models](https://docs.github.com/en/github-models) and [extensions](https://github.com/features/copilot/extensions), but those are different lessons!
+> You can also select different [models](https://docs.github.com/en/github-models) and [extensions](https://github.com/features/copilot/extensions), but that's for a different lesson!
 
 ### How can I use GitHub Copilot?
 
-As you work, you'll find GitHub Copilot can help out in several places across the website and in your favorite coding environments such as VS Code, Jet Brains, XCode! For today's coding though, we will practice with VS Code in a preconfigured development environment known as [Codespace](https://github.com/features/codespaces).
+As you work, you'll find GitHub Copilot can help out in several places across the website and in your favorite coding environments such as VS Code, Jet Brains, and Xcode! For today's coding though, we will practice with VS Code in a preconfigured development environment known as [Codespace](https://github.com/features/codespaces).
 
 ### :keyboard: Activity: Get a project intro from Copilot Chat :robot:
 
@@ -42,9 +43,10 @@ Let's start up our development environment, use copilot to learn a bit about the
 
 1. In the left sidebar, click the extensions tab and verify that the `GitHub Copilot` and `Python` extensions are installed and enabled.
 
-   ![image](https://github.com/user-attachments/assets/c1ddca93-723d-4c62-a309-5944e5dfc6f4)
+   <img width="350" alt="image" src="https://github.com/user-attachments/assets/ef1ef984-17fc-4b20-a9a6-65a866def468" />
+
+   <img width="350" alt="image" src="https://github.com/user-attachments/assets/3040c0f5-1658-47e2-a439-20504a384f77" />
 
-   <!-- Change above image to also display the python and python debugger extensions. -->
 
 1. At the top of VS Code, locate and click the **Copilot icon** to open a Copilot Chat panel.
 
@@ -54,9 +56,9 @@ Let's start up our development environment, use copilot to learn a bit about the
    @workspace Please briefly explain the structure of this project. What should I do to run it?
    ```
 
-   > **Tip**: No need to follow these steps. The environment is already configured.
+   > **Tip**: No need to follow Copilot's recommended steps. We already prepared the environment for you.
 
-1. Now that we know a bit more about the project, let's actually try runnning it! In the left sidebar, select the `Run and Debug` tab and then press the **Start Debuggin** icon.
+1. Now that we know a bit more about the project, let's actually try runnning it! In the left sidebar, select the `Run and Debug` tab and then press the **Start Debugging** icon.
 
    <img width="300" alt="image" src="https://github.com/user-attachments/assets/50b27f2a-5eab-4827-9343-ab5bce62357e" />
 
@@ -70,7 +72,7 @@ Let's start up our development environment, use copilot to learn a bit about the
 
 ### :keyboard: Activity: Use Copilot to help remember a terminal command :robot:
 
-Great work! Now that you are familiar with our app, let's ask copilot for helping starting a branch so we can do some customizing.
+Great work! Now that we are familiar with the app and we know it works, let's ask copilot for help starting a branch so we can do some customizing.
 
 1. If not already there, return to VS Code.
 
@@ -80,15 +82,15 @@ Great work! Now that you are familiar with our app, let's ask copilot for helpin
 
 1. Within the new terminal window, `right click` and select `Copilot` then `Terminal Inline Chat`.
 
-   > **Pro Tip:** You can also open inline chat with the keyboard shortcut `Ctrl + I` (windows) `Cmd + I` (mac).
+   > **Pro Tip:** You can also open inline chat with the keyboard shortcut `Ctrl + I` (windows) or `Cmd + I` (mac).
 
 1. Let's ask Copilot to help us remember a command we have forgotten, creating a branch and publishing it.
 
    ```txt
    Hey copilot, how can I create and publish a new Git branch?
    ```
 
-   > **Tip:** This is a simple example, but Copilot is great at providing more tailored commands that might involve loops, pattern matching, file modification, and more! Don't be afraid to ask Copilot for a suggestion. Just remember it is suggestion and you should always verify it first to be safe.
+   > **Tip:** This is a simple example, but Copilot is great at providing more tailored commands that might involve loops, pattern matching, file modification, and more! Don't be afraid to ask Copilot for a suggestion. Just remember it is a suggestion and you should always verify it first to be safe.
 
 1. Copilot probably gave us a command like the following. Rather than manually modify it, let's respond back to tell Copilot to use a particular name.
 
@@ -101,7 +103,7 @@ Great work! Now that you are familiar with our app, let's ask copilot for helpin
    Awesome! Thanks, Copilot! Let's use the branch name "accelerate-with-copilot".
    ```
 
-   > **Tip:** If something is incorrect in the response, you can always continue explaining what you need. Copilot will remember the conversation history in follow-up responses.
+   > **Tip:** If Copilot doesn't give you quite what you want, you can always continue explaining what you need. Copilot will remember the conversation history for follow-up responses.
 
 1. Now that we are happy with the command, press the `Run` button to let Copilot run it for us. No need to copy and paste!
 

.github/steps/2-first-introduction.md

@@ -1,24 +1,24 @@
 ## Step 2: Getting work done with Copilot
 
-In the previous step, we Copilot was able to help us onboard to the project. That alone is a huge time save, but now let's get some work done!
+In the previous step, we Copilot was able to help us onboard to the project. That alone is a huge time saver, but now let's get some work done!
 
 We recently learned there is a bug where students are registering for the same activites twice. That simply isn't acceptable, so let's get it fixed!
 
-Unfortunately, we were given little information to solve this problem. Let's enlist Copilot to help find the problem area and get a potential solution made.
+Unfortunately, we were given little information to solve this problem. So, let's enlist Copilot to help find the problem area and get a potential solution made.
 
-But before we do that, let's learn a bit more about Copilot.
+But before we do that, let's learn a bit more about Copilot! 🧑‍🚀
 
 ### How does Copilot work?
 
 In short, you can think of Copilot like a very focused coworker. To be effective with them, you need to provide them background (context) and clear direction (prompts). Additionally, different people are better at different things because of their unique experiences (models).
 
 - **How do we provide context?:** In our coding environment, Copilot will automatically consider nearby code and open tabs. If you are using chat, you can also explicitly refer to files.
 
-- **What model should we pick?:** For our exercise, it shouldn't matter too much. Experimenting with different models is part of the fun!
+- **What model should we pick?:** For our exercise, it shouldn't matter too much. Experimenting with different models is part of the fun! That's another lesson! 🤖
 
 - **How do I make prompts?:** Being explicit and clear helps Copilot do the best job. But unlike some traditional systems, you can always clarify your direction with followup prompts.
 
-### :keyboard: Activity: Use Copilot to fix our registration bug :robot:
+### :keyboard: Activity: Use Copilot to fix our registration bug :bug:
 
 1. Let's ask Copilot to suggest where our bug might be coming from. Open the Copilot Chat panel and ask the following.
 
@@ -73,29 +73,26 @@ In short, you can think of Copilot like a very focused coworker. To be effective
 
 ### :keyboard: Activity: Let Copilot generate sample data :robot:
 
-In new project developments, it's often helpful to have some realistic looking fake data for testing. Copilot is excellent at this task, so let's add some more sample activities and introduce our next interface: **Inline Chat**
+In new project developments, it's often helpful to have some realistic looking fake data for testing. Copilot is excellent at this task, so let's add some more sample activities and introduce another way to interact with Copilot: **Inline Chat**
 
 > [!TIP]  
-> **Inline Chat** and the **Copilot Chat** panel are very similar tools, but with slightly different automatic context.
-> As such, while Copilot Chat is good at explaining about the project, inline chat might feel more natural for asking about a particular line or function.
+> **Inline Chat** and the **Copilot Chat** panel are very similar tools, but with slightly different automatic context. As such, while Copilot Chat is good at explaining about the project, inline chat might feel more natural for asking about a particular line or function.
 
-1. If not already ready, open the `src/app.py` file.
+1. If not already open, open the `src/app.py` file.
 
 1. Near the top (about line 23), find the `activities` variable, where our example extracurricular activies are configured.
 
-1. Open the inline Copilot chat by Right-clicking on any of the related lines and selecting **Copilt** and **Editor Inline Chat**.
+1. Open Copilot inline chat by right-clicking on any of the related lines and selecting **Copilot** and **Editor Inline Chat**.
 
    > **Tip:** You can also use the keyboard command `Ctrl + I` (windows) or `Cmd + I` (mac).
 
-1. Enter the following prompt text and press the **Send and Dispatch** button.
+1. Enter the following prompt text and press enter or the **Send and Dispatch** button.
 
    ```text
    Add 2 more sports related activities, 2 more artistic activities, and 2 more intellectual activities.
    ```
 
-1. After a moment, Copilot will directly start making changes do the code. The changes will be stylized differently to make any additions and removals easy to identify. Take a moment to inspect and then press the **Accept** button.
-
-   <!-- Insert picture of diff view here -->
+1. After a moment, Copilot will directly start making changes to the code. The changes will be stylized differently to make any additions and removals easy to identify. Take a moment to inspect and then press the **Accept** button.
 
 <details>
 <summary>Example Results</summary><br/>
@@ -164,27 +161,6 @@ activities = {
 
 </details>
 
-<!-- 1. You can use Copilot Chat inline to stay in the flow. It's often used when you are dealing with problems or want to understand a specific part of the code.
-
-   Hold down left button of your mouse and select this part of the file.
-
-   ```python
-   current_dir = Path(__file__).parent
-   app.mount("/static", StaticFiles(directory=os.path.join(Path(__file__).parent,
-          "static")), name="static")
-   ```
-
-   Then `Right click` =>`Copilot` => `Editor Inline Chat` and use the `/explain` function. -->
-
-<!-- 1. Open up Copilot Chat window and ask Copilot to help you create a completely new endpoint to the API
-
-   ```txt
-   Hey Copilot! Create a endpoint that will allow students to sign themselves out from an activity
-   ```
-
-   On the bottom part of Copilot Chat you can choose what AI Model Copilot should use. Different models can provide different results.
-   ![image](https://github.com/user-attachments/assets/2668c5f8-1f28-4361-bf07-0b67d6a4e7c4) -->
-
 ### :keyboard: Activity: Use Copilot to describe our work :robot:
 
 Nice work fixing that bug and expanding the example activities! Now let's get our work committed and pushed to GitHub, again with the help of Copilot!
@@ -199,9 +175,9 @@ Nice work fixing that bug and expanding the example activities! Now let's get ou
 
 1. Above the list of staged changes, find the **Message** text box, but **don't enter anything** for now.
 
-   - Typically, you would write a short description of the changes here. But now we have Copilot!
+   - Typically, you would write a short description of the changes here, but now we have Copilot to help out!
 
-1. To the right of the **Message** text box, find and click the **Generate Commit Message with Copilot** button (:sparkles: icon).
+1. To the right of the **Message** text box, find and click the **Generate Commit Message with Copilot** button (sparkles icon).
 
 1. Press the **Commit** button and **Sync Changes** button push your chagnes to GitHub.
 

.github/steps/3-copilot-edits.md

@@ -1,8 +1,8 @@
 ## Step 3: Getting work done even _faster_ with Copilot Edits
 
-In our previous steps, we used features of Copilot that require more hands-on guidance and produced single isolated results. Now, we will explore a Copilot feature that works more holistically on our repo.
+In our previous steps, we used features of Copilot that require more hands-on guidance and they produced mostly localized results. Now, we will explore Copilot Edits, a feature that allows working more holistically on our repo.
 
-[Copilot Edits](https://code.visualstudio.com/docs/copilot/copilot-edits) works is an AI-powered code editing session to make changes across **multiple files** using natural language, and applies the edits directly in the editor, where you can review them in-place, with the full context of the surrounding code.
+[Copilot Edits](https://code.visualstudio.com/docs/copilot/copilot-edits) is an AI-powered code editing session to make changes across **multiple files** using **natural language**, and applies the edits directly in the editor, where you can review them in-place, with the full context of the surrounding code.
 
 #### Key features
 
@@ -35,13 +35,13 @@ In our previous steps, we used features of Copilot that require more hands-on gu
 
    > **Tip:** You can also use the **Attach files...** button to provide other sources of context items, like a GitHub issue, the entire codebase, or the results of a terminal window.
 
-1. Ask Copilot to display the current participants. Wait a moment for the suggestions to arrive and be applied.
+1. Ask Copilot to update our project to display the current participants of activities. Wait a moment for the edit suggestions to arrive and be applied.
 
    ```txt
    Hey Copilot, can you please edit the area where activities are listed on the website to show what participants are already signed up for that activity.
    ```
 
-   - An extra icon has appeared next to the file names and open editor windows indicating they have been temporarily modified.
+   - An extra icon has appeared next to the file names and open editor windows indicating they have suggested edits.
    - A suggested edits panel has appeared in the bottom right of the editor window providing controls to jump to the recommended changes.
 
       <img width="200" alt="files with icons indicating they have been edited" src="https://github.com/user-attachments/assets/9c7c2e10-cd18-43c5-9947-cffd6dde0473" />
@@ -57,7 +57,7 @@ In our previous steps, we used features of Copilot that require more hands-on gu
 
    </details>
 
-1. Before we simply accept the changes, please check our website again and verify everything is updated as expected. Here is an example of an updated activity card.
+1. Before we simply accept the changes, please check our website again and verify everything is updated as expected. Here is an example of an updated activity card. **Important:** Your results may look slightly different!
 
    <img width="350" alt="Activity card with participant info" src="https://github.com/user-attachments/assets/59fe792e-d587-487d-8525-2548ac0a7adf" />
 
@@ -84,7 +84,7 @@ In our previous steps, we used features of Copilot that require more hands-on gu
 
 If you don't get feedback, here are some things to check:
 
-- Make sure your pushed the changes in the `src/static/` directory to the branch `accelerate-with-copilot`.
-- Make sure you opened a pull request to the `main` branch
+- Make sure your commite the changes in the `src/static/` directory to the branch `accelerate-with-copilot` and pushed/synchronized to GitHub.
+- If Mona found a mistake, simply make a correction and push your changes again. Mona will check your work as many times as needed.
 
 </details>

.github/steps/4-copilot-on-github.md

@@ -14,16 +14,26 @@ Now, let's see how Copilot can help us finish up with during our pull request.
    - **compare:** `accelerate-with-copilot`
    - **title:** `Add registration validation and more activities`
 
-1. In the **Add a description** toolbar, click the **Copilot actions** icon and **Summary** action to generate a descriptive summary based on the changes made in the pull request! :memo:
+1. **Use Copilot to add a description** - In the **Add a description** toolbar, click the **Copilot actions** icon and **Summary** action to describe your changes. :memo:
 
-1. In the right side information panel, at the top, locate the **Reviewers** section and click the **Request** button next to a Copilot icon.
+1. **Ask Copilot to review your changes** - In the right side information panel at the top, locate the **Reviewers** section and click the **Request** button next to a **Copilot icon**.
 
 1. Below the pull request description, press the green **Create pull request** one more time.
 
-1. Wait a moment for Copilot to comment on your pull request!
+1. Wait a moment for Copilot to add a review comment to your pull request!
 
    - Notice the log entry indicating a Copilot review was requested.
 
-1. Back on the exercise issue, wait a moment for Mona to check your work, provide feedback, and post a final review of this lesson!
+1. Wait a moment for Mona to check your work, provide feedback, and post a final review of this lesson!
 
 1. At the bottom, press the green **Merge pull request** button. Nice work! You are all done! :tada:
+
+<details>
+<summary>Having trouble? 🤷</summary><br/>
+
+If you don't get feedback, here are some things to check:
+
+- Make sure Copilot generated a description.
+- Make sure Copilot was requested to provide a review.
+
+</details>