Skip to content

[skill-activity] Add Before You Start section to 02a-setup-codespace.md - #2287

Merged
pelikhan merged 1 commit into
mainfrom
fix/02a-add-before-you-start-8a740a9959f3f2fd
Jul 28, 2026
Merged

[skill-activity] Add Before You Start section to 02a-setup-codespace.md#2287
pelikhan merged 1 commit into
mainfrom
fix/02a-add-before-you-start-8a740a9959f3f2fd

Conversation

@github-actions

Copy link
Copy Markdown
Contributor

What was improved

Added a formal ## 📋 Before You Start section to workshop/02a-setup-codespace.md, the first hands-on step in the core workshop path.

Learner pain point addressed

The step previously jumped straight into instructions without explicitly confirming what account access learners need. The prerequisite checklist existed but was buried under a plain-text label rather than a recognized rubric section, leaving learners to discover missing Codespaces access mid-task.

Changes

  • Added a Before You Start section with account/Codespaces prerequisites and a TIP callout about free-tier hours
  • Moved the existing Verify checklist into the new section
  • Trimmed VS Code desktop troubleshooting to a side-quest link, reducing concept count toward the 15-concept threshold

Why it helps workshop flow

Learners can now self-screen before starting, reducing mid-step failures. Addresses curriculum-eval issue #2285 (scaffolding score 5.0/10).

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

  • awmgmcpg

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

Generated by 🧩 Workshop Skill Activity Author · 25.3 AIC · ⌖ 6.16 AIC · ⊞ 5.1K ·

  • expires on Jul 29, 2026, 5:42 AM UTC

- Add formal prerequisite section before the steps, satisfying the
  scaffolding rubric (curriculum-eval #2285)
- Move the 'Verify you are on the right path' checklist into the new
  section so learners confirm account/Codespaces access before starting
- Add a TIP callout about free-tier Codespaces hours
- Trim VS Code desktop troubleshooting entry to a linked side quest,
  reducing concept count toward the ≤15 threshold

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions github-actions Bot added documentation Improvements or additions to documentation skill-activity workshop labels Jul 28, 2026
@pelikhan
pelikhan marked this pull request as ready for review July 28, 2026 11:47
@pelikhan
pelikhan merged commit 227c4f2 into main Jul 28, 2026
1 check passed
@pelikhan
pelikhan deleted the fix/02a-add-before-you-start-8a740a9959f3f2fd branch July 28, 2026 11:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation skill-activity workshop

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant