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

Aperta Adatta ai principianti
  • Qualcosa non va?
#5,544 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
75/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
github-actions, markdown
Ambito
documentation

Direzione di ricerca

Inizia da workshop/04-github-actions-intro.md e confronta il Quick Refresher con i cinque termini usati nell’attività di etichettatura. Mantieni le sezioni Checkpoint e Before You Start, il tono in seconda persona e i titoli non numerati; riduci i concetti, aggiungi un elemento pratico, quindi esegui il comando markdownlint indicato nell’issue. Il lavoro è completato quando il refresher rispetta il limite di concetti indicato e il comando di lint ha esito positivo.

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.4 / 10.0 (corpus mean: 6.1)

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 6.8 ≥ 8 (≤ 15 concepts, ≤ 800 words) −1.2 (28 concepts vs 15)
active_learning 3.9 ≥ 10 (density ≥ 3) −6.1

(checkpoint/scaffolding penalties are a rubric artifact, see the rubric-regex issue; the page does have both sections.)

Root Cause (≤ 2 sentences):
The page introduces ~28 new terms (trigger, job, runner, action, step, workflow file, etc.) in 756 words, which exceeds the 15-concept guideline. Activity density is low (5 checklist items, few code blocks) relative to the prose.

Evidence (quoted from the file):

You'll do a fast refresher on the Actions primitives used in this workshop: triggers, jobs, steps, and workflow files.

Learning Science Rationale:
Sweller's Cognitive Load Theory holds that working memory handles only a handful of novel elements at once; presenting 28 terms in one sitting raises intrinsic load beyond novices' capacity. Chunking terms around the five already-labelled parts (trigger, job, runner, action, step) and deferring the rest follows the segmenting principle in Mayer's multimedia learning.

Improvement Prompt (for an agent):

Edit workshop/04-github-actions-intro.md. Reduce new concepts to ≤ 15 by limiting the "Quick Refresher" to the five terms used in the labelling activity (trigger, job, runner, action, step) and moving any extra terminology to a collapsed <details> or a link to the Actions side quest. Add one more hands-on item (a short code block the learner edits or a labelling prompt). Keep the existing "## :white_check_mark: Checkpoint" and "## :clipboard: Before You Start" sections, second-person tone, and no numbered headings. Run `npx --yes markdownlint-cli2 "workshop/04-github-actions-intro.md"`.

Expected Score After Fix: 7.0 / 10.0 (≈ 8.5 once the rubric regex is fixed)

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

  • expires on Nov 11, 2026, 3:04 AM UTC
Lingua principale
JavaScript
Stelle
58
Fork
40
Merge medio
1g 22h
PR unite (30g)
7

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.