feat: Initial version of the introductory course to GitHub Copilot

Author: FidelusAleksander

.devcontainer/devcontainer.json

@@ -0,0 +1,15 @@
+{
+  "name": "Python 3",
+  "image": "mcr.microsoft.com/vscode/devcontainers/python:3.9",
+  "features": {
+    "ghcr.io/devcontainers/features/python:1": {
+      "version": "3.13"
+    }
+  },
+  "postCreateCommand": "pip install -r requirements.txt",
+  "customizations": {
+    "vscode": {
+      "extensions": ["GitHub.copilot"]
+    }
+  }
+}

.github/steps/1-preparing.md

@@ -0,0 +1,66 @@
+## Step 1: Preparing
+
+Welcome to **"Accelerate with GitHub Copilot"** exercise! :robot:
+
+In this exercise, you will be using different GitHub Copilot features to work on a website that allows students of Mergington High School to sign up for extracurricular activities :student:
+
+### What is GitHub Copilot?
+
+GitHub Copilot is an AI coding assistant that helps you write code faster and with less effort, allowing you to focus more energy on problem solving and collaboration.
+
+GitHub Copilot has been proven to increase developer productivity and accelerate the pace of software development. For more information, see [Research: quantifying GitHub Copilot’s impact on developer productivity and happiness in the GitHub blog.](https://github.blog/news-insights/research/research-quantifying-github-copilots-impact-on-developer-productivity-and-happiness/)
+
+### How can I use GitHub Copilot?
+
+### :keyboard: Activity: Getting to know basic Copilot features :robot:
+
+1. Right-click the below button to open the **Create Codespace** page in a new tab.
+
+   [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/{{full_repo_name}}?quickstart=1)
+
+   - The free tier of Codespaces that comes with all GitHub accounts is fine, assuming you still have minutes available.
+   - The default Codespace settings are fine.
+   - This repository will provide the additional settings and files for making your extension.
+
+1. Confirm the **Repository** field is your copy of the exercise, not the original, then click the green **Create Codespace** button.
+
+   - ✅ Your copy: `/{{{full_repo_name}}}`
+   - ❌ Original: `/skills/accelerate-with-copilot`
+
+1. Wait a moment for Visual Studio Code to load in your browser.
+
+1. Click the extensions sidebar tab and verify that `GitHub Copilot` extension is installed.
+
+   <!-- TODO: Add screenshot -->
+
+1. Search for the Copilot Icon on the top right section of your editor.
+   Open up Copilot Chat and ask Copilot to introduce you to the project, to do that type `/explain` in the Chat Window.
+   <!-- TODO: Add screenshot -->
+1. Run the project by using  `Run and Debug` section in the left sidebar of VS Code. Then head to the ports tab and open the application available on port 8000
+
+   <!-- TODO: Add screenshot -->
+
+1. Great! Now that you know what we will be working with, let's have your first interaction with Copilot.
+
+   Open up a terminal in VS Code so you won't interrupt the debug session you just started.
+
+   Next, `Right click` within the newly created terminal window, then click `Copilot` => `Terminal Inline Chat`.
+
+   This feature can help you with any shell commands, in our case let's ask Copilot
+
+   ```txt
+   Hey copilot, how can I create and publish a new git branch? The branch should be named accelerate-with-copilot
+   ```
+
+   Copilot will provide you with a list of commands that it thinks you should run. If something feels off, you can Ask Copilot to fix or customize the commands further and when you are ready, press `Run` and Copilot will run the commands for you in your terminal!
+
+1. Wait a moment for the bot to check your work. You will see a comment with progress info and the next lesson.
+
+   <details>
+   <summary>Having trouble? 🤷</summary><br/>
+
+   If you don't get feedback, here are some things to check:
+
+   - Make sure your created the branch with the exact name `accelerate-with-copilot`. No prefixes or suffixes.
+
+   </details>

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

@@ -0,0 +1,66 @@
+## Step 2: First interaction with Copilot
+
+There are many Copilot Features and interaction modes. In this step you will get to use some of them:
+
+- **Code completions**: As you type, Copilot suggests code completions directly in your editor. Can generate entire functions based on comments or existing code context.
+- **Copilot Chat**: A chat interface that lets you ask coding-related questions. You will see different modes in which you can use Copilot chat
+
+> [!NOTE]
+> You can see see all currently available GitHub Copilot features that are live or in preview in the documentation. See [GitHub Copilot Features](https://docs.github.com/en/copilot/about-github-copilot/github-copilot-features)
+
+**What is context?**: GitHub Copilot context refers to comments or existing code that Copilot uses to understand your intent and generate relevant code suggestions.
+
+### :keyboard: Activity: Getting to know basic Copilot features :robot:
+
+1. Open `src/app.py` file and let's start working on improving our High School API :robot:!.
+
+   To start off - you will add additional validation to the `signup_for_activity` endpoint. Right now there is no logic to prevent users to sign to the same activity twice.
+
+   Within the code of `signup_for_activity` endpoint, write a comment to provide Copilot context of what it is you are trying to do
+
+   ```python
+   # Validate student is not already signed
+   ```
+
+   Then press `Enter` to go to newline and Copilot will provide you with autocompletion suggestions!
+
+   Press `Tab` to accept your first Copilot suggestion :tada: :robot:
+
+   > **TIP**: If you would like to see other suggestions, instead of pressing `Tab`, hover over the suggestion and a small panel will show up. On it's right side click the three dots `...` and select `Open Completions Panel`
+
+
+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.
+
+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. In the `Source Control` section on the left sidebar of VS Code.
+   1. Click the `+` sign next to  `app.py` file to stage your changes.
+   1. On the right side of the commit message window click :sparkles: to generate commit message with copilot
+   1. Commit and sync your changes with the automatically generated message
+
+1. Wait a moment for the bot to check your work. You will see a comment with progress info and the next lesson.
+
+   <details>
+   <summary>Having trouble? 🤷</summary><br/>
+
+   If you don't get feedback, here are some things to check:
+
+   - Make sure your pushed the `src/app.py` file changes to the branch `accelerate-with-copilot`.
+
+   </details>

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

@@ -0,0 +1,64 @@
+## Step 3: GitHub Copilot Edits
+
+ [Copilot Edits](https://code.visualstudio.com/docs/copilot/copilot-edits) works as an AI-powered code editing session to make changes across multiple files using natural language.
+
+ Copilot Edits applies the edits directly in the editor, where you can review them in-place, with the full context of the surrounding code.
+
+**Key features:**
+
+- **Multi-file Editing**: Copilot Edits can make changes across multiple files in your workspace.
+- **Iterative Workflow**: Designed for fast iteration, allowing you to review, accept, or discard AI-generated code.
+- **In-place Edits**: Shows generated code directly in your editor, providing a code review-like flow.
+- **Working Set**: Allows you to define which files the edits should be applied to.
+
+
+**How it works:**
+
+- **Set Context**: Define the working set by selecting files.
+- **Provide Instructions**: Use natural language to tell Copilot what changes you need.
+- **Review Changes**: See proposed changes in-place in your code
+- **Accept or Discard**: Review each AI-generated edit and choose which changes to keep
+- **Iterate**: Provide follow-up instructions and refine the changes as needed
+
+### :keyboard: Activity: Let's add a feature!
+
+1. In the top left part of Copilot Chat window, switch the Copilot Edits.
+1. Add the following files to the working set. Use the attach button in the bottom left corner of Copilot Edits view.
+    - `src/static/app.js`
+    - `src/static/index.html`
+    - `src/static/styles.css`
+1. Ask Copilot to add a new feature to the website.
+
+    ```txt
+    Hey Copilot. Edit the area where activities are listed on the website to show what participants are already signed for that activity.
+    ```
+
+    Copilot will generate inline edits for you. You can accept them or if this wasn't what you were hoping for, provide Copilot additional instructions.
+
+   > **TIP:** On the bottom part of Copilot Edits you can choose what AI Model Copilot should use. Different models can provide different results.
+
+1. Head back to the website and see your changes!
+    <details>
+   <summary>Having trouble? 🤷</summary><br/>
+
+    Remember, you can access the website url from the `ports` tab.
+
+    If the website is not available, check that it is still running. You can run in through the left sidebar's `Run and Debug` section.
+
+   </details>
+
+1. Commit and push the changes.
+1. Head back to your repository on github.com and open up a pull request to the `main` branch.
+   <!-- TODO: Add link -->
+
+1. Wait a moment for the bot to check your work. You will see a comment with progress info and the next lesson.
+
+   <details>
+   <summary>Having trouble? 🤷</summary><br/>
+
+   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
+
+   </details>

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

@@ -0,0 +1,27 @@
+## Step 4: Using GitHub Copilot within a pull request
+
+Congratulations! You are finished with coding for this exercise :tada:
+
+Now, let's see what Copilot can do for you in the context of your pull request
+
+### :keyboard: Activity: Working with GitHub Copilot on your Pull Request :robot:
+
+1. Open up the pull request you created.
+1. Let's use Copilot to generate a summary of the pull request! :memo:
+   1. Click the three dots `...` on top right of the pull request description box and click `Edit`
+   1. Click the Copilot icon and trigger the `Summary` generation action
+   1. Copilot will generate a descriptive summary based on the changes made in the pull request :robot:
+1. On the right side of the pull request view, in the `Reviewers` section, request Copilot code review.
+1. Sit back a minute and wait for Copilot to comment on your pull request!
+
+1. Wait a moment for the bot to check your work. You will see a comment with progress info and the next lesson.
+
+   <details>
+   <summary>Having trouble? 🤷</summary><br/>
+
+   If you don't get feedback, here are some things to check:
+
+   - Make sure your requested review from Copilot
+
+   </details>
+

.github/steps/x-review.md

@@ -0,0 +1,28 @@
+## Review
+
+_Congratulations, you've completed this exercise and learned a lot about GitHub Copilot!_
+
+<img src="https://octodex.github.com/images/jetpacktocat.png" alt=celebrate width=200 align=right>
+
+Here's a recap of your accomplishments:
+
+- Set up your GitHub Codespace and environment.
+- Learned how to use Copilot Autosuggestions, Chat and Edits.
+- Used Copilot to generate commit messages and pull request summaries
+- Learned how to request Copilot to review your code
+
+### What's next?
+
+- Continue working on the project
+  - Use Copilot to fix issues found by GitHub Copilot in pull request review
+  - Use Copilot to generate tests and documentation
+  - Try using different AI Models
+- Check out the other [GitHub Skills exercises](https://skills.github.com).
+  - Try building your first [GitHub Copilot Extension](https://github.com/skills/your-first-extension-for-github-copilot)
+
+
+Check out these resources to learn more about GitHub Copilot :
+- Are you not getting the responses you want from Copilot? [Learn prompt engineering](https://docs.github.com/en/copilot/using-github-copilot/copilot-chat/prompt-engineering-for-copilot-chat)
+- Explore GitHub Copilot [Slash Commands](https://docs.github.com/en/copilot/using-github-copilot/copilot-chat/github-copilot-chat-cheat-sheet?tool=vscode)
+- See what other features are available [GitHub Copilot Features](https://docs.github.com/en/copilot/about-github-copilot/github-copilot-features)
+- Take a look at the GitHub Copilot [Documentation](https://docs.github.com/en/copilot)