Skip to content

Commit 6646065

Browse files
committed
Update 1-hour guides to enhance clarity and improve user experience
1 parent 123adaf commit 6646065

File tree

2 files changed

+10
-8
lines changed

2 files changed

+10
-8
lines changed

content/1-hour/1-add-endpoint.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ Let's build our new route in our Flask backend with the help of code completion.
2828
> [!IMPORTANT]
2929
> For this exercise, **DO NOT** copy and paste the code snippet provided, but rather type it manually. This will allow you to experience code completion as you would if you were coding back at your desk. You'll likely see you only have to type a few characters before GitHub Copilot begins suggesting the rest.
3030
31-
1. Return to VS Code with the project open.
31+
1. Return to your IDE with the project open.
3232
2. Open **server/app.py**.
3333
3. Locate the comment which reads `## HERE`, which should be at line 68.
3434
4. Delete the comment to ensure there isn't any confusion for Copilot, and leave your cursor there.

content/1-hour/2-explore-project.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -8,28 +8,30 @@ Before adding new functionality to the website, you want to explore the existing
88

99
## Chat participants and extensions
1010

11-
GitHub Copilot Chat has a set of available chat participants and extensions available to you to both provide instructions to GitHub Copilot and access external services. Chat participants are helpers which work inside your IDE and have access to your project, while extensions can call external services and provide information to you without having to open separate tools. We're going to focus on one core chat participant - `@workspace`.
11+
GitHub Copilot Chat has a set of available [chat participants](https://code.visualstudio.com/docs/copilot/copilot-chat#_chat-participants) and [extensions](https://docs.github.com/en/copilot/using-github-copilot/using-extensions-to-integrate-external-tools-with-copilot-chat) available to you to both provide instructions to GitHub Copilot and access external services. Chat participants are helpers which work inside your IDE and have access to your project, while extensions can call external services and provide information to you without having to open separate tools. We're going to focus on one core chat participant - `@workspace`.
1212

1313
`@workspace` creates an index of your project and allows you to ask questions about what you're currently working on, to find resources inside the project, or add it to the context. It's best to use this when the entirety of your project should be considered or you're not entirely sure where you should start looking. In our current scenario, since we want to ask questions about our project, `@workspace` is the perfect tool for the job.
1414

1515
> [!NOTE]
1616
> This exercise doesn't provide specific prompts to type, as part of the learning experience is to discover how to interact with Copilot. Feel free to talk in natural language, describing what you're looking for or need to accomplish.
1717
18-
1. Open the repository in your IDE.
19-
2. Open GitHub Copilot Chat.
20-
3. Select the `+` icon towards the top to begin a new chat.
21-
4. Type `@workspace` in the chat prompt window and hit <kbd>tab</kbd> to select or activate it, then continue by asking Copilot about your project. You can ask what technologies are in use, what the project does, where functionality resides, etc.
22-
5. Spend a few minutes exploring to find the answers to the following questions:
18+
1. Return to your IDE with the project open.
19+
2. Close any tabs you may have open in your IDE to ensure the context for Copilot chat is empty.
20+
3. Open GitHub Copilot Chat.
21+
4. Select the `+` icon towards the top to begin a new chat.
22+
5. Type `@workspace` in the chat prompt window and hit <kbd>tab</kbd> to select or activate it, then continue by asking Copilot about your project. You can ask what technologies are in use, what the project does, where functionality resides, etc.
23+
6. Spend a few minutes exploring to find the answers to the following questions:
2324
- Where's the database the project uses?
2425
- What files are involved in listing dogs?
2526

2627
## Summary and next steps
2728

28-
You've explored context in GitHub Copilot, which is key to generating quality suggestions. You saw how you can use chat participants to help guide GitHub Copilot. Let's see how we can provide even more context to Copilot chat through the use of [Copilot instructions](./3-copilot-instructions.md).
29+
You've explored context in GitHub Copilot, which is key to generating quality suggestions. You saw how you can use chat participants to help guide GitHub Copilot, and how with natural language you can explore the project. Let's see how we can provide even more context to Copilot chat through the use of [Copilot instructions](./3-copilot-instructions.md).
2930

3031
## Resources
3132

3233
- [Copilot Chat cookbook](https://docs.github.com/en/copilot/copilot-chat-cookbook)
3334
- [Use Copilot Chat in VS Code](https://code.visualstudio.com/docs/copilot/copilot-chat)
35+
- [Copilot extensions marketplace](https://github.com/marketplace?type=apps&copilot_app=true)
3436

3537
**NEXT:** [Add Copilot instructions for additional context](./3-copilot-instructions.md)

0 commit comments

Comments
 (0)