[curriculum-eval] side-quest-01-02-environment-reference.md: cognitive_load — 1433-word glossary with 0.63 activity density
Maintainers usually reply within 3 days
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 76/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- markdown
- Domain
- documentation
Research direction
Read workshop/side-quest-01-02-environment-reference.md and identify the longest tool reference sections and opportunities for learner practice. Reduce the page to 900 words or fewer, add two active-learning steps, and preserve the Before You Start and Checkpoint sections. If you add a side quest file, update workshop/README.md; run the specified markdownlint command when finished.
Written by the indexing model from the issue text.
Description
File: workshop/side-quest-01-02-environment-reference.md
Overall Score: 4.9 / 10.0 (corpus mean: 6.1)
Flagged Dimensions:
| Dimension | Score | Benchmark | Delta |
|---|---|---|---|
| cognitive_load | 6.3 | ≥ 9 (≤ 800 words, ≤ 15 concepts) | −2.7+ (1433 words, 17 concepts) |
| active_learning | 2.1 | ≥ 10 (density ≥ 3) | −7.9 (density 0.63) |
(checkpoint/scaffolding zeros are a regex artefact, see the rubric issue; the page does have both sections.)
Root Cause (≤ 2 sentences):
The page packs ~9 tools and environments into one 1433-word reference (almost 2× the corpus median), with only 2 code blocks and 7 checklist items. A single scroll of glossary entries has no practice between concepts.
Evidence (quoted from the file):
"This is a reference page — you can read it any time. Come back here whenever the workshop uses a term you want to clarify."
Learning Science Rationale:
Sweller's Cognitive Load Theory predicts that presenting many unrelated elements at once exceeds working memory; Mayer's segmenting principle recommends splitting content into learner-paced chunks. A long glossary with little interaction encourages passive reading rather than retrieval practice.
Improvement Prompt (for an agent):
Edit workshop/side-quest-01-02-environment-reference.md. Reduce it to ≤ 900 words by (1) splitting the "Workshop tools and model options" section (gh, gh-aw, Copilot CLI, Copilot app, Claude, OpenAI Codex) into a new side quest file or collapsing each entry into a one-line summary inside a table, and (2) wrapping secondary detail in <details>. Add two short active-learning steps, e.g. "run `gh --version` and note the output" and a match-the-tool-to-its-role mini quiz. Keep the Before You Start and Checkpoint sections, keep headings unnumbered, update workshop/README.md if a file is added, and run `npx --yes markdownlint-cli2 "**/*.md"`.
Expected Score After Fix: 5.5 / 10.0 with current rubric (≈ 7.3 after the rubric regex fix)
Generated by 🔬 Curriculum Quality Evaluator · copilot · auto · ~48 AIC · ⌖ ~1 AIC · ⊞ 5K · ◷
- expires on Nov 8, 2026, 3:03 AM UTC
- Dominant language
- JavaScript
- Stars
- 58
- Forks
- 40
- Avg merge
- 4d 4h
- Merged PRs (30d)
- 8
Getting set up
Starts the project's dev container in your browser, under your own GitHub account.
- No Dockerfile or Docker Compose file
- No pull request template
- No contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from githubnext/gh-aw-workshop
-
curriculum documentation quality
Difficulty 2/5 1-3 hours Newbie friendliness 77/100
githubnext/gh-aw-workshop#5437 ·
Maintainers usually reply within 3 days
-
curriculum documentation quality
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
githubnext/gh-aw-workshop#5436 ·
Maintainers usually reply within 3 days
-
curriculum documentation quality
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
githubnext/gh-aw-workshop#5434 ·
Maintainers usually reply within 3 days
-
documentation
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
githubnext/gh-aw-workshop#5427 ·
Maintainers usually reply within 3 days
-
documentation
Difficulty 1/5 Under an hour Newbie friendliness 85/100
githubnext/gh-aw-workshop#5421 ·
Maintainers usually reply within 3 days
All issues in githubnext/gh-aw-workshop
Similar issues
-
stringify escapes leading digits in pseudo-class arguments (:nth-child(1) becomes :nth-child(\31 ))Open
Difficulty 2/5 1-3 hours Newbie friendliness 83/100
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
digitalbazaar/forge#1170 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
getgrav/grav-plugin-form#664 ·
-
bug web-ui
Difficulty 2/5 1-3 hours Newbie friendliness 67/100
jenkinsci/jenkins#27705 · 3 comments ·
Maintainers usually reply within 1 day