[curriculum-eval] side-quest-01-02-environment-reference.md: cognitive_load / active_learning — 1,433-word glossary with no hands-on activity

Aperta Adatta ai principianti
  • Qualcosa non va?
#5,358 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
markdown
Ambito
content, documentation

Direzione di ricerca

Inizia da workshop/side-quest-01-02-environment-reference.md e confronta la lunghezza del glossario e i contenuti pratici con i limiti e gli esempi dell’issue. Mantieni le sezioni Before You Start e Checkpoint, conserva i fatti e il tono in seconda persona e aggiungi un breve esercizio. La pagina è pronta quando contiene al massimo 900 parole e rispetta i vincoli richiesti per callout e titoli; esegui il comando markdownlint indicato nell’issue.

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

Descrizione

curriculum documentation quality

File: workshop/side-quest-01-02-environment-reference.md
Overall Score: 4.9 / 10.0 (corpus mean: 6.1)

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 6.3 (1,433 words, 17 concepts) ≤ 800 words, ≤ 15 concepts −3.7
active_learning 2.1 (density 0.63) ≥ 3 density (score 10) −7.9

(The missing_checkpoint and scaffolding flags are scorer false positives — the page has both; see the scorer issue.)

Root Cause (≤ 2 sentences):
The page is the longest in the corpus (≈2× the 706-word median) and presents ~10 tools and environments as parallel reference entries, each with a screenshot, with only two code blocks. Nearly all content is passive reading.

Evidence (quoted from the file):

"Knowing which name maps to which role helps you follow workshop instructions without stopping to wonder what "the terminal" or "Codespaces" means in context."

Learning Science Rationale:
Sweller's Cognitive Load Theory predicts that presenting many novel elements simultaneously overloads working memory, and Mayer's segmenting principle recommends splitting content into learner-paced chunks. A long glossary of ten tools has high element interactivity-free but high volume load, and without retrieval practice (e.g. matching exercises) little is encoded.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md to reduce it to ≤ 900 words without losing facts: collapse the per-tool "Conceptual screenshots" sections into a single table (Tool | Role | When you use it | Docs) or move rarely needed tools (Claude, OpenAI Codex) into <details> blocks. Add one short active exercise, e.g. a "match the tool to its role" checklist or a terminal block running `gh --version`, `git --version`, `gh aw --version`. Keep the :clipboard: Before You Start and :white_check_mark: Checkpoint sections, keep second-person tone, do not number headings, and keep callouts ≤ 3. Run `npx --yes markdownlint-cli2 "workshop/side-quest-01-02-environment-reference.md"`.

Expected Score After Fix: 5.5 / 10.0 with current scorer (≈ 8.0 once the checkpoint/scaffolding regex defect is fixed)

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

  • expires on Nov 6, 2026, 3:32 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.