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

Closed Beginner friendly
  • Is something wrong?
#5,100 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
github-actions, markdown
Domain
content, documentation

Research direction

Start with workshop/04-github-actions-intro.md and compare the refresher with the five parts used in its labeling activity: trigger, job, runner, action, and step. Reduce the page to at most 15 new concepts while keeping it under 800 words, preserving the Before You Start and Checkpoint sections with at least four items, and adding a short hands-on activity. Run the markdownlint command given in the issue; done means the requested limits and sections are satisfied.

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 (actual 28; 756 words) −3.2
active_learning 3.9 density ≥ 3 (actual 1.19) −6.1

(missing_checkpoint dismissed: the page has a 5-item :white_check_mark: Checkpoint.)

Root Cause (≤ 2 sentences):
Word count is fine, but the page packs trigger, job, runner, action, step, YAML, permissions and the agentic comparison into a "5 minutes" refresher; the 28 concepts nearly double the benchmark. Only one code sample and a labeling activity provide practice.

Evidence (quoted from the file):

GitHub Actions in 5 Minutes ... ## Quick Refresher ... ## Why This Matters for Agentic Workflows

Learning Science Rationale:
Miller/Cowan working-memory limits (about 4 chunks) and Cognitive Load Theory predict that 28 undefined terms in a short page cause novices to retain few of them. Pre-training (Mayer) — naming and defining key terms before the process — reduces load.

Improvement Prompt (for an agent):

Edit workshop/04-github-actions-intro.md to reduce new concepts to ≤ 15 without exceeding 800 words: restrict the refresher to the five parts used in the labeling activity (trigger, job, runner, action, step), remove or defer secondary terms (e.g. permissions, matrix, secrets) with a link instead of an explanation, and fold "Why This Matters" into two sentences. Add one more short hands-on activity so activity density reaches ≥ 3. Keep the `## :clipboard: Before You Start` and `## :white_check_mark: Checkpoint` sections (≥ 4 items). Run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: 6.4 / 10.0

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

  • expires on Oct 30, 2026, 3:35 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.