[curriculum-eval] side-quest-01-02-environment-reference.md: cognitive_load — 1,536 words and 19 concepts in one reference page

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

Direzione di ricerca

Inizia da workshop/side-quest-01-02-environment-reference.md: la tabella del glossario con la colonna Docs e la sezione "Conceptual screenshots" sono le parti da spostare o ridurre. Aggiungi un blocco di comandi "Try it" dopo il glossario e aggiorna workshop/README.md se aggiungi una nuova pagina. È completato quando la pagina ha meno di 900 parole, la nuova pagina esiste ed è collegata, e npx markdownlint-cli2 "**/*.md" passa.

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

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 5.3 ≥ 8 (≤ 800 words, ≤ 15 concepts) −2.7 (1,536 words, 19 concepts)
active_learning 2.4 density ≥ 3 −0.6 (density 0.72)

(checkpoint_quality 0.0 and scaffolding 5.0 are false negatives from the rubric regex; the page has both sections.)

Root Cause (≤ 2 sentences):
The page puts a long glossary table and a long run of "conceptual screenshots" on one page (1,536 words, about 2x the 800-word ideal), with little learner action beyond the checkpoint. It is the lowest-scoring page in the corpus and trending slightly down (4.93 → 4.79).

Evidence (quoted from the file):

| GitHub Codespaces | Your cloud development environment when you choose the browser-based setup path. Pre-launched in golden-ticket workshops. | Steps 2–14: writing, compiling, and running workflows | GitHub Codespaces docs |

Learning Science Rationale:
Sweller's Cognitive Load Theory predicts that a dense four-column table with an external link in every row raises extraneous load and splits attention. Mayer's segmenting and coherence principles suggest splitting the reference into smaller chunks and dropping redundant material. Short "try it" checks (gh --version) placed next to each tool would add retrieval practice.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md. Reduce it to under 900 words: move the "Conceptual screenshots" section into a new side quest page (e.g. side-quest-01-04-environment-screenshots.md) and link to it, and remove the "Docs" column from the glossary table, linking each tool name inline instead. Add a short "Try it" command block (gh --version, git --version, gh auth status) directly after the glossary. Keep the existing "Before You Start" and Checkpoint sections (use the :white_check_mark: shortcode heading). Update workshop/README.md if a page is added. Run: npx --yes markdownlint-cli2 "**/*.md".

Expected Score After Fix: 7.0 / 10.0

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

  • expires on Nov 15, 2026, 7:04 AM UTC
Lingua principale
JavaScript
Stelle
62
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.