File: workshop/side-quest-01-02-environment-reference.md
Overall Score: 4.93 / 10.0 (corpus mean: 6.15)
Flagged Dimensions:
| Dimension |
Score |
Benchmark |
Delta |
| active_learning |
2.1 |
≥ 3 density (× 3.3, cap 10) |
-7.9 |
| cognitive_load |
6.3 |
≤ 800 words |
word_count 1433 (-6.3 pts vs ideal) |
Root Cause (≤ 2 sentences):
At 1,433 words with only 2 code blocks and 7 checklist items, this page's activity density (0.63) is roughly a fifth of the ≥3 benchmark — it is a long, mostly prose-and-table glossary (9 rows of terminology, 9 embedded conceptual screenshots) with almost no hands-on interaction folded into the reading. The flagged_issues of excessive_length and low_active_learning are both confirmed by direct inspection: the bulk of the page is passive description of tools/environments rather than tasks the learner performs.
Evidence (quoted from the file):
Knowing which name maps to which role helps you follow workshop instructions without stopping to wonder what "the terminal" or "Codespaces" means in context.
| GitHub Codespaces | Your cloud development environment... | | Visual Studio Code (VS Code) | The editor experience inside Codespaces... | | Terminal (command line) | The shell where you run workshop commands... |
Learning Science Rationale:
Mayer's Multimedia Principle favors pairing text with relevant visuals and interaction, but this page's 9 conceptual screenshots are purely illustrative with no accompanying retrieval task per image — learners passively scroll past them rather than actively engaging (contrary to Mayer's active-processing assumption). Combined with Sweller's Cognitive Load Theory, a 1,433-word reference page front-loads extraneous load (nine parallel tool descriptions with no differentiation of priority) without intrinsic-load-reducing activities like matching, quizzing, or fill-in exercises to consolidate the glossary terms into long-term memory.
Improvement Prompt (for an agent):
Edit workshop/side-quest-01-02-environment-reference.md to raise its activity density without changing its role as an optional reference page. Specifically:
1. After the "Environment and tool glossary" table, add a short self-check activity (e.g., a 4-6 item matching exercise or fill-in-the-blank quiz using <details><summary>Reveal answer</summary> pattern) that asks the learner to match 4-6 tool names to their roles before revealing answers, mirroring the interactive quiz pattern already used in workshop/05-agentic-workflows-intro.md ("Activity 2 — agentic or standard?").
2. Trim the "Conceptual screenshots" section: keep the images but collapse the per-tool one-paragraph captions into a single sentence each, or fold sibling tools (e.g. GitHub Copilot CLI + GitHub Copilot app) into shared subsections, to reduce total word count toward 900-1000 words while preserving all information density in the table.
3. Do not remove the existing checkpoint section; keep its checklist items intact.
4. Run `npx --yes markdownlint-cli2 "workshop/side-quest-01-02-environment-reference.md"` after editing and fix any lint errors.
Expected Score After Fix: 6.3 / 10.0
Generated by 🔬 Curriculum Quality Evaluator · copilot · auto · 62.1 AIC · ⌖ 23.2 AIC · ⊞ 9.5K · ◷
File:
workshop/side-quest-01-02-environment-reference.mdOverall Score:
4.93 / 10.0(corpus mean:6.15)Flagged Dimensions:
2.1-7.96.31433(-6.3pts vs ideal)Root Cause (≤ 2 sentences):
At 1,433 words with only 2 code blocks and 7 checklist items, this page's activity density (0.63) is roughly a fifth of the ≥3 benchmark — it is a long, mostly prose-and-table glossary (9 rows of terminology, 9 embedded conceptual screenshots) with almost no hands-on interaction folded into the reading. The
flagged_issuesofexcessive_lengthandlow_active_learningare both confirmed by direct inspection: the bulk of the page is passive description of tools/environments rather than tasks the learner performs.Evidence (quoted from the file):
Learning Science Rationale:
Mayer's Multimedia Principle favors pairing text with relevant visuals and interaction, but this page's 9 conceptual screenshots are purely illustrative with no accompanying retrieval task per image — learners passively scroll past them rather than actively engaging (contrary to Mayer's active-processing assumption). Combined with Sweller's Cognitive Load Theory, a 1,433-word reference page front-loads extraneous load (nine parallel tool descriptions with no differentiation of priority) without intrinsic-load-reducing activities like matching, quizzing, or fill-in exercises to consolidate the glossary terms into long-term memory.
Improvement Prompt (for an agent):
Expected Score After Fix:
6.3 / 10.0