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

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

I maintainer di solito rispondono entro 3 giorni

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, yaml

Direzione di ricerca

Inizia da workshop/04-github-actions-intro.md e verifica come introduce i concetti di workflow, le attività pratiche e il checkpoint. Confronta la pagina con i limiti indicati di 15 concetti e una densità di attività di almeno 3 ogni 100 parole; sposta i concetti avanzati nella side quest indicata e aggiungi un’attività, mantenendo le sezioni e il tono specificati. Esegui il comando markdownlint dell’issue e conferma che il checkpoint contenga ancora almeno quattro elementi.

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.06)

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 6.8 ≥ 9 (≤ 800 words, ≤ 15 concepts) −2.2 (28 new concepts vs 15)
active_learning 3.9 ≥ 10 (density ≥ 3) −6.1
checkpoint_quality 0.0 (detector bug, see the checkpoint-detector issue; real checkpoint has 4 items) ≥ 10 n/a

Root Cause (≤ 2 sentences):
The page introduces 28 new concepts in 756 words (triggers, jobs, runners, actions, steps, plus agentic comparisons), nearly double the 15-concept benchmark. Only 5 checklist items and few code blocks give an activity density of 1.9 per 100 words.

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:
Sweller's Cognitive Load Theory predicts that novices can hold only a few new elements in working memory; introducing 28 terms in one "5 minute" page before any hands-on practice raises intrinsic load and pushes learners toward passive reading. Chunking the vocabulary and interleaving each term with a short activity (worked-example effect) reduces load.

Improvement Prompt (for an agent):

Edit workshop/04-github-actions-intro.md. Reduce new concepts introduced to ≤ 15 by keeping only trigger, job, runner, action and step as taught terms and moving the rest into a link to side-quest-05-01-actions-power-user.md. Move the "Why This Matters for Agentic Workflows" comparison to a two-sentence NOTE-free paragraph. Add one more hands-on activity (a code block or checklist item the learner completes) so activity density reaches ≥ 3 per 100 words. Keep the "Already know GitHub Actions?" skip block, the "## :white_check_mark: Checkpoint" section with ≥ 4 items, second-person voice, no numbered headings. Run npx --yes markdownlint-cli2 "workshop/04-github-actions-intro.md".

Expected Score After Fix: 6.5 / 10.0 (≈ 8.4 once the checkpoint detector is fixed)

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

  • expires on Nov 9, 2026, 3:31 AM UTC
Lingua principale
JavaScript
Stelle
58
Fork
40
Merge medio
4g 4h
PR unite (30g)
8

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.