githubnext / githubnext/gh-aw-workshop

[curriculum-eval] 04-github-actions-intro.md: cognitive_load — 28 new concepts nearly double the ideal for a 5-minute refresher

Closed Beginner friendly
#3,415 0 comments 0 reactions 0 assignees View on GitHub
curriculum documentation quality
Dominant language
JavaScript
Stars
47
Forks
19
Avg merge
8h 54m
Merged PRs (30d)
50

Description

**File:** `workshop/04-github-actions-intro.md`
**Overall Score:** `5.39 / 10.0` (corpus mean: `6.14`)

**Flagged Dimensions:**

| Dimension | Score | Benchmark | Delta |
|---|---|---|---|
| active_learning | 3.9 | ≥3 activity density | -0.9 (density 1.19 vs 3.0 ideal) |
| cognitive_load | 6.8 | 10 (≤800 words, ≤15 concepts) | -3.2 (756 words is fine; 28 new concepts is the driver) |
| checkpoint_quality | 0.0 | 10 (≥4 checklist items) | -10.0 (scorer defect — see Root Cause) |

**Flagged issue `concept_overload` confirmed:** 28 new concepts (trigger, job, step, runner, action, workflow file, `on:`, `jobs:`, `steps:`, `runs-on:`, `uses:`, `run:`, self-hosted runner, agentic workflow, task brief, safe outputs, permissions model, etc.) is nearly double the 15-concept ideal, even though word count (756) is within budget.

**Root Cause (≤ 2 sentences):**
This is the workshop's first Actions primer, so it introduces the entire Actions vocabulary (trigger/job/step/runner/action) plus a preview comparison table against agentic workflows in one page, giving 28 distinct new terms — almost double the ideal — even though the prose itself is appropriately short. `checkpoint_quality` also shows 0.0 due to the corpus-wide `## :white_check_mark: Checkpoint` vs. `## ✅ Checkpoint` scorer mismatch; the real checkpoint has 5 concrete items and is not the actual gap.

**Evidence (quoted from the file):**
> A GitHub Actions workflow is a YAML file in `.github/workflows/` that tells GitHub:
> - _when_ to run (`on`)
> - _what_ to run (`jobs`)
> - _how_ each job executes (`steps`)

**Learning Science Rationale:**
Cognitive Load Theory (Sweller) distinguishes intrinsic load (the inherent difficulty of Actions vocabulary) from extraneous load (how it's presented); here the "Why This Matters for Agentic Workflows" comparison table adds four more concepts (permissions model, safe outputs, task brief execution) on top of the five core Actions primitives already taught in the same page, front-loading more novel terms than working memory can consolidate in one pass — especially for a page positioned as a "5 Minutes" refresher.

**Improvement Prompt (for an agent):**
```
Open workshop/04-github-actions-intro.md. Move the "Why This Matters for Agentic Workflows" comparison table (Trigger/Runner/Steps/Output classic-vs-agentic) out of this page and into the opening of workshop/05-agentic-workflows-intro.md instead, where those agentic-specific concepts (task brief, safe outputs, permissions model) are the primary learning objective and already have supporting context. Keep 04-github-actions-intro.md focused only on the five classic Actions primitives (trigger, job, runner, step, action) plus the existing labeling exercise and real-workflow exploration activity, reducing new_concepts from 28 toward 15-18. Update the transition sentence at the end of 04 so it still previews the connection to agentic workflows in one sentence without introducing new vocabulary. Run `npx --yes markdownlint-cli2 "**/*.md"` after editing and fix any lint errors.
```

**Expected Score After Fix:** `6.4 / 10.0`

> Generated by [🔬 Curriculum Quality Evaluator](https://github.com/githubnext/gh-aw-workshop/actions/runs/35026063971) · copilot · auto · 76.1 AIC · ⌖ 8.13 AIC · ⊞ 9.5K · [◷](https://github.com/search?q=repo%3Agithubnext%2Fgh-aw-workshop+is%3Aissue+%22gh-aw-workflow-call-id%3A+githubnext%2Fgh-aw-workshop%2Fcurriculum-evaluator%22&type=issues)
> - [x] expires on Sep 16, 2026, 9:39 PM UTC

Contributor guide

No contributing guide indexed for this repository

Research direction

Open workshop/04-github-actions-intro.md and workshop/05-agentic-workflows-intro.md. Move the comparison table as requested, keep the existing activities and a brief transition in 04, then run npx --yes markdownlint-cli2 "**/*.md". Done means 04 focuses on the classic Actions concepts, 05 contains the agentic comparison, and Markdown lint passes.

Written by the indexing model from the issue text.

Assessment

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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.