Skip to content

[skill-activity] Reduce cognitive load on Environment Reference side quest - #3579

Closed
github-actions[bot] wants to merge 1 commit into
mainfrom
workshop-improve-environment-reference-cognitive-load-030801f61c2b7c5e
Closed

github-actions[bot] wants to merge 1 commit into
mainfrom
workshop-improve-environment-reference-cognitive-load-030801f61c2b7c5e

Conversation

@github-actions

Copy link
Copy Markdown
Contributor

What changed

Improved the lowest-scoring page flagged by the curriculum quality evaluator: workshop/side-quest-01-02-environment-reference.md (score 4.93/10.0, corpus mean 6.14).

  • Split the "Conceptual screenshots" section into two collapsible <details> groups ("Development environments" and "Workshop tools and model options") so learners expand only the tool they need instead of scrolling through 10 sequential screenshots linearly.
  • Added a "Quick check" retrieval-practice exercise right after the glossary table and enterprise note, before the screenshots — a 3-question match-the-tool-to-its-role prompt with a <details> reveal-answers block, matching the exercise style used elsewhere in the workshop.
  • Trimmed the glossary table descriptions to a single clause each, cutting redundant phrasing while preserving all documentation links and workshop-step references.

Learner pain point addressed

The curriculum evaluator flagged this reference page for excessive cognitive load (1433 words, well over the ~800-word benchmark) and near-zero interactivity (activity density 0.63 vs. the ≥3 target) — learners were passively scrolling through dense prose and 10 back-to-back screenshots before doing anything themselves. Per Cognitive Load Theory and Mayer's multimedia principle, this risked working-memory overload and passive skimming on a page meant to be revisited as a lookup reference, not read linearly.

Why this helps workshop flow

  • Collapsible screenshot groups let learners jump straight to the tool they're looking up, reducing passive scroll.
  • The mid-page quick check adds a retrieval moment that reinforces the glossary before learners see the screenshots.
  • Trimmed table descriptions cut total word count while keeping every actionable detail and link intact.
  • The existing checkpoint checklist still applies unchanged against the new structure.

Warning

Firewall blocked 1 domain

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

  • registry.npmjs.org

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

network:
  allowed:
    - defaults
    - "registry.npmjs.org"

See Network Configuration for more information.

Generated by 🧩 Workshop Skill Activity Author · copilot · auto · 42.7 AIC · ⌖ 7.51 AIC · ⊞ 7.3K ·

  • expires on Sep 21, 2026, 2:43 AM UTC

- Trim glossary table descriptions to one clause each
- Add a quick-check retrieval exercise before the screenshots
- Split conceptual screenshots into two collapsible <details> groups

Addresses curriculum-eval finding: cognitive_load & active_learning,
1433-word reference page with 10 sequential screenshots and low
activity density.
@github-actions github-actions Bot added documentation Improvements or additions to documentation skill-activity workshop labels Sep 20, 2026
@github-actions

Copy link
Copy Markdown
Contributor Author

This pull request was automatically closed because it expired on 2026-09-21T02:43:00.504Z.

Closed by Workflow

@github-actions github-actions Bot closed this Sep 21, 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