[curriculum-eval] side-quest-01-02-environment-reference.md: active_learning — 1433-word glossary with density 0.63

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

Direzione di ricerca

Leggi workshop/side-quest-01-02-environment-reference.md, concentrandoti sul glossario, su “Conceptual screenshots” e sulle sezioni “Checkpoint”. Mantieni solo i termini del glossario usati nei passaggi 01–07 del workshop, condensa o suddividi la sezione degli screenshot e aggiungi 3–4 brevi verifiche dei comandi con l’output previsto. Mantieni le sezioni “Checkpoint” e “Before You Start”; esegui markdownlint-cli2 e conferma che la pagina non superi le 900 parole.

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

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 6.3 ≥ 8 (≤ 800 words) −1.7 (1433 words, 17 concepts)
active_learning 2.1 10 (density ≥ 3) −7.9 (density 0.63)

(missing_checkpoint is a false positive; the page has ## :white_check_mark: Checkpoint at line 155.)

Root Cause (≤ 2 sentences):
The lowest-scoring page is a reference glossary nearly twice the word guideline, with a "Conceptual screenshots" section (lines 54–154) dominating the page. Only 2 code blocks and 7 checklist items support 1433 words.

Evidence (quoted from the file):

When you're ready to verify your tools are working, see the Checkpoint (link unavailable: invalid HTTPS URL) section at the bottom.

Learning Science Rationale:
Mayer's coherence and segmenting principles argue that long reference material should be broken into learner-paced pieces and stripped of non-essential content; Cognitive Load Theory predicts novices cannot retain a 1400-word glossary without applying it. Adding short "try it" commands converts passive reference into retrieval practice.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md. Reduce to ≤ 900 words by tightening the glossary (keep only terms used in workshop steps 01–07) and condensing or splitting the "Conceptual screenshots" section into a collapsed <details> or a separate side quest. After the glossary add 3–4 short "check it yourself" code blocks (e.g. `gh --version`, `git --version`) with expected output. Keep the Checkpoint with ≥ 4 items and the Before You Start section; update workshop/README.md if you add a file; run markdownlint-cli2.

Expected Score After Fix: 6.8 / 10.0

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.