Skip to content

Commit c36bcf0

Browse files
Update lab environment setup instructions and getting started page (#9)
* add getting started page * update lab environment setup instructions * Update lab environment setup instructions and getting started page --------- Co-authored-by: Rakesh Lakshminarayana <rakesh.lakshminarayana@insight.com>
1 parent a074f75 commit c36bcf0

6 files changed

+73
-49
lines changed

docs/00-Welcome.md

Lines changed: 29 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -5,45 +5,54 @@ slug: /
55

66
# GitHub Copilot Labs
77

8-
A list of publicly available GitHub Copilot workshops and hackathons you can use to upskill your team.
8+
Welcome to GitHub Copilot Labs! 🎉🚀
99

10-
Insight can help you with your GitHub Copilot adoption journey. Find out more by emailing us at [marketing-apac@insight.com](mailto:marketing-apac@insight.com?Subject=GitHub%20Copilot%20Adoption%20Help).
10+
We are excited to have you join us!
1111

12-
## Visual Studio Code (or GitHub Codespaces)
12+
Our labs are designed to immerse you in GitHub Copilot and enhance your coding journey through persona-specific tracks.
13+
Whether you're a frontend developer, backend developer, full stack engineer, DevOps engineer, data engineer, or data scientist, we have something for you.
1314

14-
### Front End
15+
Dive in and explore the incredible world of GitHub Copilot! 🌟🤖
16+
17+
Here’s how to get started:
18+
19+
1. **Explore Our Labs**:Check out our curated list of workshops designed for different developer personas.
20+
2. **Get Support**: Insight can help you with your GitHub Copilot adoption journey. Find out more by emailing us at [marketing-apac@insight.com](mailto:marketing-apac@insight.com?Subject=GitHub%20Copilot%20Adoption%20Help).
21+
3. **Contribute**: Have suggestions for additional workshops or labs? Submit an Issue or PR, and we’ll consider adding them to our list!
22+
23+
Happy coding! 💻✨
24+
25+
![image](./images/gitHub-copilot-adoption-personas.png)
26+
27+
### Frontend Developers
1528

1629
- [GitHub Copilot Workshop for Front-end developers](https://github.com/GitHub-Insight-ANZ-Lab/copilot-lab-weather-app-react) (React, Typescript, Javascript, CSS)
1730

18-
### Back End
31+
### Backend Developers
1932

2033
- [GitHub Copilot Hackathon ASP.NET Minimal API](https://github.com/GitHub-Insight-ANZ-Lab/copilot-hackathon-minimal-api-csharp) (C#, ASP.NET Core)
2134
- [GitHub Copilot Hackathon Java Spring Boot](https://github.com/GitHub-Insight-ANZ-Lab/copilot-hackathon-java-spring-boot) (Java, Spring Boot)
2235
- [GitHub Copilot Lab C# Console App](https://github.com/GitHub-Insight-ANZ-Lab/copilot-lab-music-store-csharp-console) (C#, .NET)
2336
- [GitHub Copilot Lab Node Calculator](https://github.com/GitHub-Insight-ANZ-Lab/copilot-node-calculator) (Node.js)
2437

25-
### Full Stack
38+
### Full Stack Engineers
2639

27-
- [SPA Music Store with GitHub Copilot](https://github.com/GitHub-Insight-ANZ-Lab/copilot-lab-music-store-typescript) (Node.js Express, Next.js, TypeScript, HTML, CSS)
40+
- [SPA Music Store with GitHub Copilot](https://github.com/GitHub-Insight-ANZ-Lab/copilot-lab-music-store-typescript) (Node.js Express, Next.js, TypeScript, HTML,
41+
CSS)
42+
- [MVC Music Store with GitHub Copilot](https://github.com/GitHub-Insight-ANZ-Lab/copilot-lab-music-store-csharp) (C#, ASP.NET Core MVC, HTML, CSS)
43+
44+
### DevOps Engineers
45+
46+
- [GitHub Copilot Hackathon DevOps](https://github.com/GitHub-Insight-ANZ-Lab/copilot-hackathon-devops) (Azure, Terraform, Docker, GitHub Actions)
2847

29-
### Data Engineer
48+
### Data Engineers
3049

3150
- [GitHub Copilot Hackathon for Python Data Engineer](https://github.com/GitHub-Insight-ANZ-Lab/copilot-hackathon-data-engineer-python) (Python, Jupyter Notebooks)
3251
- [GitHub Copilot Lab for SQL](https://github.com/GitHub-Insight-ANZ-Lab/copilot-lab-sql) (SQL Database Development)
3352

34-
### Data Scientist
53+
### Data Scientists
3554

3655
- [GitHub Copilot Hackathon for Python Data Scientist](https://github.com/GitHub-Insight-ANZ-Lab/copilot-hackathon-data-scientist-python) (Python, Jupyter Notebooks)
3756
- [GitHub Copilot Lab in R](https://github.com/GitHub-Insight-ANZ-Lab/copilot-lab-r) (R for Statistical Computing)
3857

39-
### DevOps
40-
41-
- [GitHub Copilot Hackathon DevOps](https://github.com/GitHub-Insight-ANZ-Lab/copilot-hackathon-devops) (Azure, Terraform, Docker, GitHub Actions)
42-
43-
## Visual Studio 2022+
44-
45-
### Full Stack
46-
47-
- [MVC Music Store with GitHub Copilot](https://github.com/GitHub-Insight-ANZ-Lab/copilot-lab-music-store-csharp) (C#, ASP.NET Core MVC, HTML, CSS)
48-
49-
Know any other workshops or labs we're missing, submit an Issue or PR and we'll consider adding them!
58+
---

docs/01-Getting Started.md

Lines changed: 42 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -5,59 +5,72 @@ slug: /getting-started
55

66
Choose the exercise that best suits your interests and skill level.To complete the exercises, you will need an environment with GitHub Copilot and a supported IDE such as VS Code.
77

8-
The following section provides instructions on setting up your environment. There may be additional setup steps required for specific exercises, so be sure to read the README file for the exercise you choose.
8+
The following section provides instructions on setting up your environment. There may be additional setup required for specific exercises, so be sure to read the **README** file for the exercise you choose.
99

1010
:::tip
11-
It is recommended to fork the repository to your GitHub account before starting the exercise. This will allow you to save your changes and track your progress. Navigate to the exercise repository and click the "Fork" button in the top right corner to create a copy in your GitHub account.
11+
It is recommended to fork the repository to your GitHub account before starting the exercise. This will allow you to save your changes and track your progress.
12+
13+
Navigate to the exercise repository and click the "Fork" button in the top right corner to create a copy in your GitHub account.
1214
:::
1315

14-
## Setting Up Your Environment
16+
## 👨🏻‍💻 Setting Up Your Environment
1517

1618
### Step 1: GitHub Copilot License
1719

18-
Check with your organization to see if you have a GitHub Copilot license available.
20+
Check with your organization to see if you have a GitHub Copilot license available.
1921

20-
If you do not have a license, you can sign up for a trial [here](https://github.com/github-copilot/signup).
22+
If you do not have a license, you can sign up for a trial [here](https://github.com/github-copilot/signup).
2123

2224
### Step 2: Setting Up Your IDE
2325

24-
**OPTION 1: Use your local computer**
26+
**OPTION 1: Use your local computer**
2527

26-
The following IDEs are supported for GitHub Copilot:
28+
The following IDEs are supported for GitHub Copilot:
2729

28-
- VSCode (Recommended)
29-
- Visual Studio
30-
- NeoVIM
31-
- JetBrains IDE
30+
- VSCode (Recommended)
31+
- Visual Studio
32+
- NeoVIM
33+
- JetBrains IDE
3234

33-
You can choose the IDE that suits your preference and install it on your local machine.
35+
You can choose the IDE that suits your preference and install it on your local machine.
3436

35-
### Step 3: Install GitHub Copilot Extension
37+
**OPTION 2: Use CodeSpaces**
3638

37-
Install the GitHub Copilot extension for your chosen IDE:
39+
CodeSpaces is a cloud-based development environment that allows you to develop entirely in the cloud. You can use CodeSpaces to complete the exercises without installing any software on your local machine.
3840

39-
- **VSCode**: [Install VSCode Extension](https://docs.github.com/en/copilot/getting-started-with-github-copilot?tool=vscode#installing-the-visual-studio-code-extension)
40-
- **Visual Studio**: [Install Visual Studio Extension](https://docs.github.com/en/copilot/getting-started-with-github-copilot?tool=visualstudio#installing-the-visual-studio-extension)
41-
- **NeoVIM**: [Install NeoVIM Extension](https://docs.github.com/en/copilot/getting-started-with-github-copilot?tool=neovim#installing-the-neovim-extension-on-macos)
42-
- **JetBrains IDE**: [Install JetBrains Extension](https://docs.github.com/en/copilot/getting-started-with-github-copilot?tool=jetbrains#installing-the-github-copilot-extension-in-your-jetbrains-ide)
41+
Check with your organization if you have access to CodeSpaces and confirm if the lab exercises are supported in CodeSpaces.
4342

44-
:::tip
45-
If you encounter issues due to Firewall or VPN restrictions, contact your IT team to whitelist the GitHub Copilot extension. Troubleshooting information can be found [here](https://docs.github.com/en/copilot/troubleshooting-github-copilot/troubleshooting-common-issues-with-github-copilot).
46-
:::
43+
You can find more information on how to use CodeSpaces here - https://docs.github.com/en/codespaces/getting-started/quickstart
4744

48-
**OPTION 2: Use CodeSpaces**
45+
![image](./images/474979958-8f0799d2-ec1f-4b8e-9f5a-16f8d0bc2611.png)
4946

50-
CodeSpaces is a cloud-based development environment that allows you to develop entirely in the cloud. You can use CodeSpaces to complete the exercises without installing any software on your local machine. Check with your organization if you have access to CodeSpaces and confirm if the lab exercises are supported in CodeSpaces.
47+
### Step 3: Install GitHub Copilot Extension
5148

52-
You can find more information on how to use CodeSpaces [here](https://docs.github.com/en/codespaces/getting-started/quickstart).
49+
Install the GitHub Copilot extension for your chosen IDE:
50+
51+
| IDE | Download Link |
52+
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|
53+
| **VSCode** | [VSCode Extension](https://docs.github.com/en/copilot/getting-started-with-github-copilot?tool=vscode#installing-the-visual-studio-code-extension) |
54+
| **Visual Studio** | [Visual Studio Extension](https://docs.github.com/en/copilot/getting-started-with-github-copilot?tool=visualstudio#installing-the-visual-studio-extension) |
55+
| **NeoVIM** | [NeoVIM Extension](https://docs.github.com/en/copilot/getting-started-with-github-copilot?tool=neovim#installing-the-neovim-extension-on-macos) |
56+
| **JetBrains IDE** | [JetBrains Extension](https://docs.github.com/en/copilot/getting-started-with-github-copilot?tool=jetbrains#installing-the-github-copilot-extension-in-your-jetbrains-ide) |
57+
58+
59+
:::tip
60+
If you encounter issues due to Firewall or VPN restrictions, contact your IT team to whitelist the GitHub Copilot extension. Troubleshooting information can be found [here](https://docs.github.com/en/copilot/troubleshooting-github-copilot/troubleshooting-common-issues-with-github-copilot).
61+
:::
5362

5463
### Step 4: Fork and Clone the Repository
5564

56-
1. **Fork the Repository**: Navigate to the exercise repository and fork it to your GitHub account.
57-
2. **Clone the Repository**: Clone the forked repository to your local machine using Git. If you are using CodeSpaces, you can open the repository directly in CodeSpaces.
58-
3. **Open in IDE**: Open the cloned repository in your chosen IDE.
59-
4. **Enable GitHub Copilot**: Ensure the GitHub Copilot extension is enabled and sign in to your GitHub account if required. Check the status bar in your IDE to confirm that GitHub Copilot is active.
65+
1. Navigate to the exercise repository and fork it to your GitHub account.
66+
2. Clone the forked repository to your local machine using Git. If you are using CodeSpaces, you can open the repository directly in CodeSpaces.
67+
3. Open the cloned repository in your chosen IDE.
68+
4. Ensure the GitHub Copilot extension is enabled and sign in to your GitHub account if required. Check the status bar in your IDE to confirm that GitHub Copilot is active.
69+
70+
![image](./images/574979958-8f0799d2-ec1f-4b8e-9f5a-16f8d0bc2622.png)
6071

6172
### Step 5: Additional Setup
6273

63-
- Follow any additional setup mentioned in the README file of the exercise repository.
74+
- Follow any additional setup mentioned in the **README** file of the exercise repository.
75+
76+
---

docs/100-Additional-Resources.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,3 +13,5 @@ slug: /additional-resources
1313
- [GitHub Copilot 101 - Mastering GitHub Copilot for AI Paired Programming](https://github.com/microsoft/Mastering-GitHub-Copilot-for-Paired-Programming) (JavaScript, Python and C#)
1414
- [GitHub Copilot Workshops](https://github.com/copilot-workshops) (Node, Python and Terraform)
1515
- [Microsoft GitHub Copilot Hackathon](https://github.com/GitHub-Partner-Demo-Library/MicrosoftCopilotHackathon) (Node, Java, Python, C#)
16+
17+
---
271 KB
Loading
7.9 KB
Loading
260 KB
Loading

0 commit comments

Comments
 (0)