[curriculum-eval] side-quest-11-06-anthropic-key.md: cognitive_load — 26 new concepts in a 685-word setup guide

Chiusa Adatta ai principianti
  • Qualcosa non va?
#5,257 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
62/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
github-actions, markdown
Ambito
documentation

Direzione di ricerca

Il file da modificare è workshop/side-quest-11-06-anthropic-key.md; inizia dal paragrafo introduttivo, che collega in linea molti termini, e dai passaggi numerati che descrivono azioni nell'interfaccia o nella CLI. Riduci l'introduzione a due frasi, collega ogni termine solo al primo utilizzo e trasforma le azioni in brevi blocchi di comandi, come gh secret set ANTHROPIC_API_KEY e lo snippet di frontmatter engine: claude. È completato quando il Checkpoint contiene ancora cinque voci, il numero di concetti è di circa 15 o meno e npx --yes markdownlint-cli2 "**/*.md" supera il controllo.

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

Descrizione

curriculum documentation quality

File: workshop/side-quest-11-06-anthropic-key.md
Overall Score: 5.37 / 10.0 (corpus mean: 6.06)

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 7.2 ≥ 8 (≤ 15 concepts) −0.8 (26 concepts)
active_learning 3.4 ≥ 10 (density ≥ 3) −6.6 (density 1.02)

Root Cause (≤ 2 sentences):
Intro and step text pack dense inline links and terms (engine, secrets, frontmatter, network allowlist, compile) into a short guide. The step-by-step actions have few commands/code blocks relative to prose.

Evidence (quoted from the file):

By default, agentic workflows run on the GitHub Copilot engine. If you prefer to use Claude ...

Learning Science Rationale:
Mayer's coherence and signalling principles: linking every term inline adds extraneous load. Defining a term once, then using plain words, and putting each action in a code block or checklist reduces split attention.

Improvement Prompt (for an agent):

Edit workshop/side-quest-11-06-anthropic-key.md: link each concept only on first use, trim the intro to 2 sentences, convert the UI/CLI actions into short numbered commands or code blocks (e.g. gh secret set ANTHROPIC_API_KEY, the engine: claude frontmatter snippet, gh aw compile), and keep the Checkpoint at 5 items. Target ≤ 15 new concepts. Run npx --yes markdownlint-cli2 "**/*.md".

Expected Score After Fix: 6.5 / 10.0 (≈ 8.5 once the rubric detection bug is fixed)

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

  • expires on Nov 3, 2026, 4:04 AM UTC
Lingua principale
JavaScript
Stelle
56
Fork
40
Merge medio
2g 14h
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.