diff --git a/.github/images/add-to-devcontainer-button.png b/.github/images/add-to-devcontainer-button.png
new file mode 100644
index 000000000..1ba42c51e
Binary files /dev/null and b/.github/images/add-to-devcontainer-button.png differ
diff --git a/.github/images/codespaces-list.png b/.github/images/codespaces-list.png
new file mode 100644
index 000000000..36f3ca1e5
Binary files /dev/null and b/.github/images/codespaces-list.png differ
diff --git a/.github/images/configure-dev-container-command.png b/.github/images/configure-dev-container-command.png
new file mode 100644
index 000000000..19703f465
Binary files /dev/null and b/.github/images/configure-dev-container-command.png differ
diff --git a/.github/images/delete-codespace-command.png b/.github/images/delete-codespace-command.png
new file mode 100644
index 000000000..12aa49290
Binary files /dev/null and b/.github/images/delete-codespace-command.png differ
diff --git a/.github/images/green-code-button.png b/.github/images/green-code-button.png
new file mode 100644
index 000000000..bbdca9c34
Binary files /dev/null and b/.github/images/green-code-button.png differ
diff --git a/.github/images/python-extensions.png b/.github/images/python-extensions.png
new file mode 100644
index 000000000..dad28516e
Binary files /dev/null and b/.github/images/python-extensions.png differ
diff --git a/.github/images/rebuild-codespace-command.png b/.github/images/rebuild-codespace-command.png
new file mode 100644
index 000000000..28a952c6f
Binary files /dev/null and b/.github/images/rebuild-codespace-command.png differ
diff --git a/.github/images/remote-connection-status.png b/.github/images/remote-connection-status.png
new file mode 100644
index 000000000..bed328bd7
Binary files /dev/null and b/.github/images/remote-connection-status.png differ
diff --git a/.github/images/run-and-debug-start-button.png b/.github/images/run-and-debug-start-button.png
new file mode 100644
index 000000000..094166499
Binary files /dev/null and b/.github/images/run-and-debug-start-button.png differ
diff --git a/.github/images/vs-code-explorer-tab.png b/.github/images/vs-code-explorer-tab.png
new file mode 100644
index 000000000..62a8f93c7
Binary files /dev/null and b/.github/images/vs-code-explorer-tab.png differ
diff --git a/.github/images/vs-code-extensions-tab.png b/.github/images/vs-code-extensions-tab.png
new file mode 100644
index 000000000..d8931ce7f
Binary files /dev/null and b/.github/images/vs-code-extensions-tab.png differ
diff --git a/.github/images/vs-code-terminal-tab.png b/.github/images/vs-code-terminal-tab.png
new file mode 100644
index 000000000..3bc484738
Binary files /dev/null and b/.github/images/vs-code-terminal-tab.png differ
diff --git a/.github/steps/1-first-codespace.md b/.github/steps/1-first-codespace.md
index 8836befbe..e4df467ba 100644
--- a/.github/steps/1-first-codespace.md
+++ b/.github/steps/1-first-codespace.md
@@ -33,13 +33,13 @@ Let's get started! We'll start up a Codespace, run the application, make a chang
1. Above the files list on the right, click the green **<> Code** button.
-
+
1. Select the **Codespaces** tab and click the **Create codespace on main** button. A new window will open running VS Code and it will connect to the remote Codespace. Wait a few minutes for the codespace to be created.
1. Look in the bottom left of the VS Code window see the remote connection.
-
+
> [!TIP]
> GitHub uses the [universal](https://github.com/devcontainers/images/tree/main/src/universal) Codespace image if the repository doesn't include a configuration. It includes several useful and commonly used tools.
@@ -50,11 +50,11 @@ Let's get started! We'll start up a Codespace, run the application, make a chang
1. In the left sidebar, select the file **Explorer** tab and open the file `src/hello.py`.
-
+
1. In the lower panel, select the **TERMINAL** tab.
-
+
1. Paste the following command in the Codespace's remote terminal to show the installed versions of several tools. Note the versions for comparison later.
diff --git a/.github/steps/2-custom-image.md b/.github/steps/2-custom-image.md
index afdc68086..01ae61d60 100644
--- a/.github/steps/2-custom-image.md
+++ b/.github/steps/2-custom-image.md
@@ -40,7 +40,7 @@ Let's create this file and set a few of the most common settings. For other opti
1. After saving, VS Code likely popped up a notification that it detected a configuration change. You can **Accept** that option to rebuild the development container or manually use the Command Palette (`CTRL`+`Shift`+`P`) and run the command `Codespaces: Rebuild Container`. Select the **Rebuild** option. A full build is not necessary.
-
+
1. Wait a few minutes for the Codespace to rebuild and VS Code to reconnect.
diff --git a/.github/steps/3-customize-codespace.md b/.github/steps/3-customize-codespace.md
index 5fc4c5d48..3b233fac6 100644
--- a/.github/steps/3-customize-codespace.md
+++ b/.github/steps/3-customize-codespace.md
@@ -12,7 +12,7 @@ Let's add the GitHub CLI, extensions to run the python program using VS Code, an
Codespaces: Add Dev Container Configuration Files...
```
-
+
1. Select the option `Modify your active configuration...`.
@@ -39,15 +39,15 @@ Let's add the GitHub CLI, extensions to run the python program using VS Code, an
1. In the left navigation, select the **Extension** tab.
-
+
1. Search for `python` and find entries for `Python` and `Python Debugger`.
-
+
1. Right click on each entry and select the `Add to devcontainer.json` option.
-
+
1. Navigate to and open the `.devcontainer/devcontainer.json` file.
@@ -116,7 +116,7 @@ The Dev Container specification provides multiple locations to run [lifecycle sc
1. Open the VS Code Command Palette (`CTRL`+`Shift`+`P`) and run the `Codespaces: Rebuild Container` command. Select the **Rebuild** option. A full build is not necessary.
-
+
1. Wait a few minutes for the Codespace to rebuild and VS Code to reconnect.
@@ -133,11 +133,11 @@ Now that you've rebuilt the codespace, let's verify the python extension, python
1. In the left sidebar, click the extensions tab and verify that the Python extensions are installed and enabled.
-
+
1. In the left sidebar, select **Run and Debug** tab and then press the **Start Debugging** icon. VS Code will open the lower panel and show the run logs.
-
+
1. In the lower panel, switch to the **TERMINAL** tab.
diff --git a/.github/steps/4-use-codespace.md b/.github/steps/4-use-codespace.md
index 5bc0de72f..a410fc511 100644
--- a/.github/steps/4-use-codespace.md
+++ b/.github/steps/4-use-codespace.md
@@ -12,11 +12,11 @@ The final test of our Codespace is to put ourselves in the position of an onboar
1. Select the **Codespaces** tab to show the list of created Codespaces.
-
+
1. Find the active entry, select the three dot menu `...`, and select the **Delete** command.
-
+
> [!TIP]
> You can manage all of your Codespaces across all projects at https://github.com/codespaces
diff --git a/.github/workflows/0-start-exercise.yml b/.github/workflows/0-start-exercise.yml
index 4fb47ea03..2c2b86e26 100644
--- a/.github/workflows/0-start-exercise.yml
+++ b/.github/workflows/0-start-exercise.yml
@@ -18,7 +18,7 @@ jobs:
if: |
!github.event.repository.is_template
name: Start Exercise
- uses: skills/exercise-toolkit/.github/workflows/start-exercise.yml@v0.5.0
+ uses: skills/exercise-toolkit/.github/workflows/start-exercise.yml@v0.8.1
with:
exercise-title: "Code with Codespaces"
intro-message: "Let's create a pre-configured environment to simplify development!"
@@ -33,6 +33,8 @@ jobs:
steps:
- name: Checkout
uses: actions/checkout@v4
+ with:
+ ref: main
- name: Get response templates
uses: actions/checkout@v4