Skip to content

[skill-activity] Improve environment reference: add when-you-use-it column, enterprise note, and cleaner checkpoint - #2798

Draft
github-actions[bot] wants to merge 1 commit into
mainfrom
improve/side-quest-01-02-environment-reference-b7209bef9005ae4d
Draft

[skill-activity] Improve environment reference: add when-you-use-it column, enterprise note, and cleaner checkpoint#2798
github-actions[bot] wants to merge 1 commit into
mainfrom
improve/side-quest-01-02-environment-reference-b7209bef9005ae4d

Conversation

@github-actions

Copy link
Copy Markdown
Contributor

What was improved

Improved workshop/side-quest-01-02-environment-reference.md — the lowest-scoring file in the curriculum scorecard (5.31/10).

Changes:

  • Added a "When you use it" column to the glossary table so learners know not just what each tool is but when they will reach for it
  • Added a [!NOTE] callout for GHES/GHEC enterprise learners pointing to enterprise Copilot docs
  • Added a brief orienting sentence at the top explaining why the page exists
  • Tightened the checkpoint to concrete, actionable items — including the key takeaway that gh aw runs at author time, not on the runner
  • Removed redundant wording in the tool-verification section

Learner pain point addressed

The page previously listed tools with brief descriptions but gave no signal about when a learner would use each one. Beginners stalled trying to map abstract terms to concrete workflow moments.

Why it helps workshop flow

With "When you use it" context, learners can return to this reference at any point and immediately locate the tool relevant to their current step. The enterprise note prevents GHES/GHEC learners from hitting silent dead ends when Codespaces or model options behave differently in their org.

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 · 46.3 AIC · ⌖ 6.77 AIC · ⊞ 5.1K ·

  • expires on Aug 26, 2026, 5:00 AM UTC

…se note, cleaner checkpoint

- Add a 'When you use it' column to the glossary table so learners
  understand not just what each tool is but when they'll reach for it
- Add a NOTE callout for GHES/GHEC learners pointing to enterprise docs
- Add a brief orienting sentence at the top ('why this page exists')
- Tighten the checkpoint to concrete, actionable items including the
  key insight that gh-aw runs at author time, not on the runner
- Remove redundant wording in the verify-tools section

Addresses the lowest-scoring file (5.31/10) in the curriculum scorecard.

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 Aug 25, 2026
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.

0 participants