Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

[curriculum-eval] side-quest-11-06-anthropic-key.md: cognitive_load — 26 new concepts in 673 words, high element interactivity in frontmatter bloc

Chiusa Adatta ai principianti
  • Qualcosa non va?
#4,198 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
markdown
Ambito
documentation

Direzione di ricerca

Leggi workshop/side-quest-11-06-anthropic-key.md, concentrandoti sulla sezione “Update your workflow frontmatter” e sulle due sezioni relative alle chiavi API. Apporta le modifiche richieste alle spiegazioni e ai callout, lasciando invariato il checkpoint di cinque elementi. Esegui npx --yes markdownlint-cli2 "**/*.md"; il lavoro è concluso quando le modifiche richieste sono state apportate e il comando di lint termina correttamente.

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

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 7.2 ≤ 15 new concepts -2.8 (26 new concepts in only 673 words)
active_learning 3.4 density ≥ 3 -1.1 (density 1.04)
checkpoint_quality 0.0* ≥ 4 items present → ≥10 false negative, see note

*Note: the file has a well-formed ## :white_check_mark: Checkpoint with 5 items; the 0.0 is the shared rubric regex bug (see companion issue). The real issue here is concept density, not missing structure.

Root Cause (≤ 2 sentences):
Despite being a short page (673 words, under the 800-word ideal), it packs 26 distinct bolded/code terms — ANTHROPIC_API_KEY, engine: claude, copilot-requests: write, network.allowed, api.anthropic.com, gh aw compile, and a full secret-creation UI walkthrough — into a single linear sequence with only 4 code blocks and 5 checklist items to anchor them. This is a textbook "concept overload" pattern: word count alone looks fine, but the density of new named entities per 100 words (26 concepts / 6.7 "hundreds" ≈ 3.9 concepts per 100 words) is unusually high for a side-quest meant to be a quick, low-stress configuration task.

Evidence (quoted from the file):

"Open your workflow .md file and update the frontmatter:" followed by a single code block introducing five new frontmatter keys at once (permissions, engine: claude, network.allowed, defaults, api.anthropic.com) with only one sentence of explanation ("switch from the default Copilot engine to Claude") for the whole block.

Learning Science Rationale:
Cognitive Load Theory's concept of element interactivity explains why this page feels harder than its word count suggests: the five frontmatter keys in the final code block are not independent facts but interact (changing engine requires changing network.allowed and possibly removing copilot-requests: write), and all of that interactivity is presented in one unannotated block rather than built up incrementally. High-interactivity material should be chunked and annotated inline (e.g., a comment per changed line) rather than left for the learner to reverse-engineer from a single terse sentence.

Improvement Prompt (for an agent):

Edit workshop/side-quest-11-06-anthropic-key.md to reduce concept density in the "Update your
workflow frontmatter" section:
1. Add an inline YAML comment on every changed line in the frontmatter code block explaining
   why it changed, not just what changed — for example:
   engine: claude          # switches the agent's model provider from Copilot to Claude
   network:
     allowed:
       - defaults
       - api.anthropic.com  # required: Claude's API calls must reach this domain
2. Add one short sentence immediately after the code block clarifying the dependency between
   engine: claude and the network.allowed entry, e.g. "Because engine and network.allowed
   are linked, forgetting api.anthropic.com here is the most common cause of workflow
   failures after this step."
3. Split the "Get an Anthropic API key" and "Store the key as a repository secret" sections'
   combined 2 IMPORTANT/NOTE callouts so the most load-bearing warning (key shown once) stays
   prominent, and move pricing information to a single short sentence rather than a separate
   callout, reducing total callout_count from 3 toward 2.
4. Keep the existing ":white_check_mark: Checkpoint" section with its 5 items unchanged.
5. Re-run `npx --yes markdownlint-cli2 "**/*.md"` after editing.

Expected Score After Fix: 7.6 / 10.0 (cognitive_load improves via reduced element interactivity; checkpoint_quality already corrects to ~10.0 once the shared regex bug is fixed)

Generated by 🔬 Curriculum Quality Evaluator · copilot · auto · 123.7 AIC · ⌖ 14.5 AIC · ⊞ 10.4K · ◷

  • expires on Oct 5, 2026, 9:22 PM UTC
Lingua principale
JavaScript
Stelle
53
Fork
35
Merge medio
1g 6h
PR unite (30g)
15

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.