docs: update steps and improve instructions for clarity and consistency (#5)

* docs: update steps and improve instructions for clarity and consistency

* docs: indent step3

* docs: remove overexplanation step3

* Add screenshot to step2

Author: FidelusAleksander

.github/steps/1-step.md

@@ -51,39 +51,41 @@ We are using the same web application as in the [Getting Started with Copilot](h
 
 1. Inside your codespace, create a new file named `mcp.json` in the `.vscode` directory and paste the following contents:
 
-```json
-// .vscode/mcp.json
-{
-  "servers": {
-    "github": {
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-github"],
-      "env": {
-        "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:githubToken}"
+   ```json
+   // .vscode/mcp.json
+   {
+   "servers": {
+      "github": {
+         "command": "npx",
+         "args": ["-y", "@modelcontextprotocol/server-github"],
+         "env": {
+         "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:githubToken}"
+         }
       }
-    }
-  },
-  "inputs": [
-    {
-      "type": "promptString",
-      "id": "githubToken",
-      "description": "Enter your GitHub personal access token",
-      "password": true
-    }
-  ]
-}
-```
-
-1. Save the file and you should see `Start` button show up like so:
-
-   ![image](https://github.com/user-attachments/assets/c82a4202-1f4a-4123-ad14-5e33ecd6316c)
+   },
+   "inputs": [
+      {
+         "type": "promptString",
+         "id": "githubToken",
+         "description": "Enter your GitHub personal access token",
+         "password": true
+      }
+   ]
+   }
+   ```
 
-1. When you start the server, you will be prompted to provide a GitHub Token. You can use the token provided to you by the GitHub Codespace you are working in.
+1. In a moment, when you start the server - you will be prompted to provide a GitHub Token. Print it out in the terminal and copy it to your clipboard (`CTRL+C`).
 
    ```bash
       echo $GITHUB_TOKEN
    ```
 
+1. Back in the `.vscode/mcp.json` file you should see `Start` button show up like so:
+
+   ![image](https://github.com/user-attachments/assets/c82a4202-1f4a-4123-ad14-5e33ecd6316c)
+
+1. Click the `Start` button to launch the GitHub MCP server locally. When prompted, paste the GitHub token you copied earlier.
+
 1. Validate the server is running.
 
    1. The `.vscode/mcp.json` file should show if the server you started is running

.github/steps/2-step.md

@@ -33,6 +33,17 @@ Let's use GitHub Copilot Agent Mode together with GitHub MCP server to work on t
    > Are there any open bug report issues on my repository ({{{full_repo_name}}}) ?
    > ```
 
+   <details>
+   <summary>:camera_flash: Copilot should figure out that it can use GitHub MCP server for this. </summary><br/>
+
+   <img width="400px" src="https://github.com/user-attachments/assets/7a9aea70-7c50-46d8-848e-092ade825573" />
+
+   </details>
+   
+   
+   
+
+
    > 🪧 **Note:** We explicitly include the repository name to add it to Copilot's session context. For subsequent prompts, this context will be preserved in the conversation.
 
    > ✨ **Bonus:** You are welcome to try the prompt without it and if Copilot chooses to list issues in a different repository, guide it your way.
@@ -44,7 +55,7 @@ Let's use GitHub Copilot Agent Mode together with GitHub MCP server to work on t
    > ```prompt
    > Okay, let's start working on the bug report.
    > Comment on the issue that I will take a look at the issue and try to fix it.
-   > Create a new branch, introduce the changes and raise a pull request to the `main` branch
+   > Introduce the changes to the activities, push the changes to a new branch, and raise a pull request to `main`.
    > ```
 
    > ⚠️ **Warning:** Always verify the information that Copilot passes to the MCP server before accepting.

.github/steps/3-step.md

@@ -11,19 +11,8 @@ While AI assistants like GitHub Copilot can dramatically improve productivity, i
 
 1. Examine the [pull request]({{{pull_request_url}}}) Copilot helped you create.
 
-> ✨ **Bonus:** If your access is sufficient, you can ask Copilot to review your code.
+   > ✨ **Bonus:** If your access is sufficient, you can ask Copilot to review your code.
 
 1. Once you're satisfied with the changes, merge the pull request
 
-  >  🪧 **Note:** If you are not satisfied, go back to the codespace and work with Copilot to introduce the changes. Remember, coding is an iterative process.
-
-<details>
-<summary>Having trouble?</summary><br/>
-
-If you encounter issues:
-
-- Make sure the PR was created correctly in the previous step
-- If needed, you can navigate directly to your repository on GitHub.com to find the PR
-- Remember that while MCP helps Copilot understand your repo better, human review is still essential
-
-</details>
+   >  🪧 **Note:** If you are not satisfied, go back to the codespace and work with Copilot to introduce the changes. Remember, coding is an iterative process.

.github/steps/4-step.md

@@ -1,6 +1,5 @@
 ## Step 4: Wrap up on the bug report
 
-
 ### :keyboard: Activity: Wrap up the bug report
 
 1. Open the **Copilot Chat Agent Mode** session in VS Code.
@@ -21,4 +20,3 @@
    - Check what information is passed to the MCP server calls - is Copilot using the correct repository?
    - Did Copilot comment on the bug report?
    </details>
-

.github/steps/x-review.md

@@ -1,18 +1,14 @@
 ## Review
 
-_Congratulations, you've completed this Exercise and joined the world of developers!_
+_Congratulations, you've completed this Exercise and learned the basics of MCP !_
 
 <img src=https://octodex.github.com/images/collabocats.jpg alt=celebrate width=300 align=right>
 
-Here's a recap of your accomplishments:
-
-
 ### What's next?
 
 
 Check out these resources to learn more or get involved:
 
 - [Take another GitHub Skills exercise](https://skills.github.com).
-_
-
-__
+- Learn more about [Model Context Protocol](https://modelcontextprotocol.io/introduction)
+- Try other MCP servers! GitHub is just one of [many](https://github.com/modelcontextprotocol/servers)

.gitignore

@@ -35,3 +35,9 @@
 .Trashes
 ehthumbs.db
 Thumbs.db
+
+# Python files
+__pycache__
+
+# Env files
+.env