[curriculum-eval] side-quest-01-02-environment-reference.md: cognitive_load — 1,536 words and 19 concepts in one reference page

Open Beginner friendly
  • Is something wrong?
#5,711 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
78/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
git, github, markdown
Domain
documentation

Research direction

Start with workshop/side-quest-01-02-environment-reference.md: the glossary table with the Docs column and the "Conceptual screenshots" section are the parts to move or trim. Add a "Try it" command block after the glossary, and update workshop/README.md if you add a new page. Done when the page is under 900 words, the new page exists and is linked, and npx markdownlint-cli2 "**/*.md" passes.

Written by the indexing model from the issue text.

Description

curriculum documentation quality

File: workshop/side-quest-01-02-environment-reference.md
Overall Score: 4.79 / 10.0 (corpus mean: 6.06)

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 5.3 ≥ 8 (≤ 800 words, ≤ 15 concepts) −2.7 (1,536 words, 19 concepts)
active_learning 2.4 density ≥ 3 −0.6 (density 0.72)

(checkpoint_quality 0.0 and scaffolding 5.0 are false negatives from the rubric regex; the page has both sections.)

Root Cause (≤ 2 sentences):
The page puts a long glossary table and a long run of "conceptual screenshots" on one page (1,536 words, about 2x the 800-word ideal), with little learner action beyond the checkpoint. It is the lowest-scoring page in the corpus and trending slightly down (4.93 → 4.79).

Evidence (quoted from the file):

| GitHub Codespaces | Your cloud development environment when you choose the browser-based setup path. Pre-launched in golden-ticket workshops. | Steps 2–14: writing, compiling, and running workflows | GitHub Codespaces docs |

Learning Science Rationale:
Sweller's Cognitive Load Theory predicts that a dense four-column table with an external link in every row raises extraneous load and splits attention. Mayer's segmenting and coherence principles suggest splitting the reference into smaller chunks and dropping redundant material. Short "try it" checks (gh --version) placed next to each tool would add retrieval practice.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md. Reduce it to under 900 words: move the "Conceptual screenshots" section into a new side quest page (e.g. side-quest-01-04-environment-screenshots.md) and link to it, and remove the "Docs" column from the glossary table, linking each tool name inline instead. Add a short "Try it" command block (gh --version, git --version, gh auth status) directly after the glossary. Keep the existing "Before You Start" and Checkpoint sections (use the :white_check_mark: shortcode heading). Update workshop/README.md if a page is added. Run: npx --yes markdownlint-cli2 "**/*.md".

Expected Score After Fix: 7.0 / 10.0

Generated by 🔬 Curriculum Quality Evaluator · copilot · auto · ~49 AIC · ⌖ ~1 AIC · ⊞ 5K · ◷

  • expires on Nov 15, 2026, 7:04 AM UTC
Dominant language
JavaScript
Stars
62
Forks
43
Avg merge
12h 23m
Merged PRs (30d)
12

Getting set up

Open in Codespaces

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

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from githubnext/gh-aw-workshop

All issues in githubnext/gh-aw-workshop

Similar issues

More JavaScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.