Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

[curriculum-eval] side-quest-01-02-environment-reference.md: cognitive_load — 1,433-word reference page with low activity density

Open Beginner friendly
  • Is something wrong?
#5,143 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
74/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
github-actions, javascript, markdown
Domain
content, documentation

Research direction

Start with workshop/side-quest-01-02-environment-reference.md, especially the glossary and conceptual screenshots sections, and check workshop/README.md if the content is split into another file. Add short terminal practice commands with expected output while keeping each section within the stated word limit and preserving at least four verifiable checkpoint items. Run npx --yes markdownlint-cli2 "**/*.md"; the evaluator’s target score is 6.5.

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.93 / 10.0 (corpus mean: 6.06)

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 6.3 ≤ 800 words +633 words over budget
active_learning 2.1 density ≥ 3 density 0.63 (−2.37)

Root Cause (≤ 2 sentences):
The page packs a glossary (lines 15–53) and a long "Conceptual screenshots" section (lines 54–154) into one file, giving 1,433 words with only 2 code blocks. It reads as reference material but has no practice tasks.

Evidence (quoted from the file):

Environment and tool glossary ... ## Conceptual screenshots

Learning Science Rationale:
Mayer's segmenting principle says complex material is learned better in learner-paced segments, and Sweller's CLT warns that long undifferentiated text raises extraneous load. Retrieval practice (Roediger & Karpicke) also shows that adding brief self-check tasks to reference content improves retention.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md. Split it into two files (glossary; conceptual screenshots) each ≤ 800 words, or collapse the screenshots section into <details> blocks. Add 2–3 short "try it" terminal commands with expected output so activity density ≥ 3 per 100 words. Keep the existing "## :white_check_mark: Checkpoint" with ≥ 4 verifiable items, update workshop/README.md if you add a file, run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: 6.5 / 10.0

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

  • expires on Oct 31, 2026, 4:04 AM UTC
Dominant language
JavaScript
Stars
56
Forks
40
Avg merge
2d 15h
Merged PRs (30d)
14

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.