diff --git a/076-GitHubCopilotCostOptimization/Coach/README.md b/076-GitHubCopilotCostOptimization/Coach/README.md index a45d595ad6..041eaac636 100644 --- a/076-GitHubCopilotCostOptimization/Coach/README.md +++ b/076-GitHubCopilotCostOptimization/Coach/README.md @@ -33,13 +33,13 @@ The guide covers the common preparation steps a coach needs to do before any Wha ### Student Resources -Before the hack, package the contents of the `/Student/Resources` folder into a Resources.zip file for students who work locally. +This hack uses GitHub Codespaces for all student resources. Students should use their personal GitHub accounts to access Codespaces which will provide a configured VS Code developer environment for them that runs in a browser, hosted in the cloud. -For students using GitHub Codespaces, prepare a student-facing repository containing the student resources and a dev container configuration. Verify that students can create a Codespace with the resources and the `076-GitHubCopilotCostOptimization` configuration, then provide the creation link and branch, if needed. Do not direct students to the What The Hack repository. +Alternatively, students may download the Student Resources package: [Resources.zip](https://aka.ms/wth/ghcpcostoptimization/resources) and use the DevContainer in it to load the pre-configured developer environment on their local workstation. -If publishing only the contents of `Student/Resources`, use its `.devcontainer/devcontainer.json` at the root of the student-facing repository. The repository-root configuration instead expects the `076-GitHubCopilotCostOptimization/Student/Resources` folder layout. +The links for the Codespace and Student Resources package are in Challenge 00 of the student guide. -The Student/Resources folder should contain: +The Codespace (and Student Resources package) contains: - **Starter codebase** with intentionally sub-optimal GitHub Copilot configuration: - Bloated `.github/copilot-instructions.md` (~1500 tokens) for Challenge 02 diff --git a/076-GitHubCopilotCostOptimization/Student/Challenge-00.md b/076-GitHubCopilotCostOptimization/Student/Challenge-00.md index f99a5b6dd6..60229b26eb 100644 --- a/076-GitHubCopilotCostOptimization/Student/Challenge-00.md +++ b/076-GitHubCopilotCostOptimization/Student/Challenge-00.md @@ -20,15 +20,18 @@ GitHub Codespaces provides a cloud-hosted Visual Studio Code environment that yo You need a GitHub account with access to GitHub Copilot and permission to use GitHub Codespaces. Codespaces compute and storage normally incur charges separately from GitHub Copilot, depending on your account's included usage and billing settings. All personal GitHub.com accounts include a monthly quota of free usage each month. GitHub will provide users in the Free plan 120 core hours, or 60 hours of run time on a 2 core codespace, plus 15 GB of storage each month. -1. Open the student Codespace creation link provided by your coach and sign in to GitHub. -2. Select the branch provided by your coach, if needed, and select `076-GitHubCopilotCostOptimization` as the **Dev container configuration**. -3. Select **Create codespace**. Once it opens, confirm that the student resources and GitHub Copilot extensions are available. -4. To return to your environment later, open [Your Codespaces](https://github.com/codespaces) and select your existing Codespace. +1. Open the Codespace for this hack: [GitHub Copilot Cost Optimization Codespace](https://aka.ms/wth/ghcpcostoptimization/codespace) +2. Sign in with your **personal** GitHub account. +3. Verify the `Dev container configuration` is set to the one for this hack, then click **Create Codespace**. +4. Wait for Visual Studio Code to load in your browser. The first launch takes approximately 3-5 minutes. Once it opens, confirm that the student resources and GitHub Copilot extensions are available. + +> **NOTE:** To return to your environment later, open [Your Codespaces](https://github.com/codespaces) and select your existing Codespace. ### Use a local workstation -1. Extract the Resources.zip file provided by your coach. -2. Open the extracted folder in Visual Studio Code and install or update the GitHub Copilot and GitHub Copilot Chat extensions. +1. [Download `Resources.zip`](https://aka.ms/wth/ghcpcostoptimization/resources), the student resources package. +2. Extract the Resources.zip file on your local workstation. +3. Open the extracted folder in Visual Studio Code and install or update the GitHub Copilot and GitHub Copilot Chat extensions. ### Set up GitHub Copilot