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

[curriculum-eval] 04-github-actions-intro.md: cognitive_load — 28 new concepts in a 5-minute intro

Closed Beginner friendly
#4,603 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
66/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
github-actions, markdown

Research direction

The work is in workshop/04-github-actions-intro.md, in the Quick Refresher, Why This Matters, the "Label a sample workflow" exercise and the exploration task. Start by listing the terms introduced in those sections and separate the five labelled parts (trigger, job, runner, action, step) from the rest. Done means only those five terms are introduced inline, other terms move behind a link or a <details> block, the labelling exercise and the Checkpoint stay, and npx markdownlint-cli2 "**/*.md" passes.

Written by the indexing model from the issue text.

Description

curriculum documentation quality

File: workshop/04-github-actions-intro.md
Overall Score: 5.4 / 10.0 (corpus mean: 6.1)

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 6.8 ≤ 15 concepts 28 concepts (+13)
active_learning 3.9 density ≥ 3 1.19

(missing_checkpoint dismissed: a 5-item checkpoint exists.)

Root Cause (≤ 2 sentences):
The page is titled "GitHub Actions in 5 Minutes" yet introduces 28 terms across Quick Refresher, Why This Matters, a labelling exercise and an exploration task.

Evidence (quoted from the file):

You labeled all five parts of the sample workflow above (trigger, job, runner, action, step)

Learning Science Rationale:
Working-memory limits (Cowan) and Cognitive Load Theory predict that more than ~15 new terms in one sitting hinder schema formation; Mayer's pre-training principle suggests naming only key terms first.

Improvement Prompt (for an agent):

Edit workshop/04-github-actions-intro.md: limit new vocabulary to the five labelled parts (trigger, job, runner, action, step), move other terms to a link or collapsed <details>, keep the "Label a sample workflow" exercise, and keep the Checkpoint. Run npx --yes markdownlint-cli2 "**/*.md".

Expected Score After Fix: 5.8 / 10.0 (before the regex fix)

Generated by 🔬 Curriculum Quality Evaluator · copilot · auto · 29.8 AIC · ⌖ 0.745 AIC · ⊞ 10.4K · ◷

  • expires on Oct 16, 2026, 7:43 AM UTC
Dominant language
JavaScript
Stars
53
Forks
35
Avg merge
13h 50m
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.