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

Aperta Adatta ai principianti
#5,895 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
82/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
github-actions, markdown

Direzione di ricerca

Leggi workshop/04-github-actions-intro.md e concentrati sul Quick Refresher, sullo YAML annotato, su “Why This Matters” e sull’esercizio di etichettatura. Verifica come vengono introdotti i cinque termini fondamentali e dove compaiono i concetti e i link aggiuntivi. Il lavoro è completato quando la pagina è limitata a questi cinque termini, mantenendo i dettagli per passare direttamente oltre, la sezione Before You Start, l’attività di etichettatura e un checkpoint con almeno quattro elementi verificabili.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

curriculum documentation quality

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

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 6.8 ≤ 15 concepts (actual 28; 766 words) −3.2
active_learning 3.9 density ≥ 3 (actual 1.17) −6.1
checkpoint_quality 0.0 (false positive: 5-item checkpoint exists) ≥ 4 items n/a

Root Cause (≤ 2 sentences):
Core path step for newcomers: the Quick Refresher, annotated YAML, "Why This Matters" and labelling exercise introduce 28 distinct terms (trigger, job, runner, step, action, on, jobs, steps, ...) in 766 words. Word count is fine; concept density is the problem.

Evidence (quoted from the file):

Already know GitHub Actions? Confirm these three statements and skip ahead: You know workflows live in .github/workflows/ as YAML files ... You can read on, jobs, and steps keys in a workflow file

Learning Science Rationale:
Miller/Sweller working-memory limits mean novices can handle only a handful of new elements at once. Reducing element interactivity by teaching five core terms (trigger, job, runner, action, step) and deferring the rest helps schema formation before the labelling activity.

Improvement Prompt (for an agent):

Edit workshop/04-github-actions-intro.md. Reduce new concepts to ≤ 15 by restricting the page to five terms: trigger, job, runner, action, step. Move extra terms/links (expressions, secrets, matrix, etc.) out or into a single "Learn more" line. Keep the skip-ahead details block, the Before You Start section, the labelling activity and the Checkpoint (≥ 4 verifiable items). No numbered headings; run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: 5.9 / 10.0 (≈ 7.9 once the checkpoint regex is fixed)

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

  • expires on Nov 20, 2026, 8:04 AM UTC
Lingua principale
JavaScript
Stelle
61
Fork
43
Merge medio
11h 26m
PR unite (30g)
13

Preparare l'ambiente

Apri in Codespaces

Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.

  • Nessun Dockerfile né file Docker Compose
  • Nessun modello di pull request
  • Nessuna guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di githubnext/gh-aw-workshop

Tutte le issue di githubnext/gh-aw-workshop

Issue simili

Altre issue su JavaScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.