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

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

Closed Beginner friendly
#4,703 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
86/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
markdown
Domain
documentation

Research direction

Read AGENTS.md conventions, then inspect workshop/side-quest-01-02-environment-reference.md and the four tool sections. Reduce the page to the requested length, consolidate the screenshot content into a compact table or <details> blocks, and add two short terminal tasks while retaining at least four Checkpoint items. Run npx --yes markdownlint-cli2 "**/*.md" to verify formatting.

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.09)

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 6.3 ≥ 8 (≤800 words) -1.7+
active_learning 2.1 ≥ 7 (density ≥ 3) -4.9+

Root Cause (≤ 2 sentences):
The page is a 1,433-word glossary table plus per-tool screenshot sections with an activity density of 0.63 (target ≥ 3). Reference content is dense and has few learner actions.

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.

Learning Science Rationale:
Sweller's Cognitive Load Theory predicts that learners can hold only a few new elements in working memory; exceeding the concept and length budget raises extraneous load and reduces schema formation. Splitting content into focused, chunked pieces with practice between them restores germane load. Mayer's coherence principle also suggests trimming the repeated per-tool screenshot sections.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md: reduce to ≤ 900 words by collapsing the four tool screenshot sections (Copilot CLI, Copilot app, Claude, OpenAI Codex) into one compact table or <details> blocks; add two short hands-on tasks (e.g. run `gh --version` and `gh extension list` in the terminal and confirm output) and keep the Checkpoint with ≥ 4 items. Follow AGENTS.md conventions and run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: 6.3 / 10.0

Generated by 🔬 Curriculum Quality Evaluator · copilot · auto · 29.6 AIC · ⌖ 0.746 AIC · ⊞ 10.4K · ◷

  • expires on Oct 19, 2026, 3:41 AM UTC
Dominant language
JavaScript
Stars
53
Forks
35
Avg merge
1d 6h
Merged PRs (30d)
15

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.