Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

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

Cerrado Apto para principiantes
  • ¿Algo no está bien?
#4,198 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
78/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
markdown
Área
documentation

Línea de trabajo

Lee workshop/side-quest-11-06-anthropic-key.md, centrándote en la sección “Update your workflow frontmatter” y en las dos secciones sobre claves de API. Realiza los ajustes solicitados en las explicaciones y los callouts, dejando sin cambios el checkpoint de cinco elementos. Ejecuta npx --yes markdownlint-cli2 "**/*.md"; la tarea estará terminada cuando se hayan realizado los cambios solicitados y el comando de lint se ejecute correctamente.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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
Lenguaje dominante
JavaScript
Estrellas
52
Forks
26
Merge medio
11 h 32 min
PR fusionados (30 d)
22

Preparar el entorno

Abrir en Codespaces

Inicia el contenedor de desarrollo del proyecto en tu navegador, con tu propia cuenta de GitHub.

  • Sin Dockerfile ni archivo de Docker Compose
  • Sin plantilla de pull request
  • Sin guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de githubnext/gh-aw-workshop

Todos los issues de githubnext/gh-aw-workshop

Issues similares

Más issues de JavaScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.