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

Abierto Apto para principiantes
#5,257 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
62/100
Tipo de issue
Documentación
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
github-actions, markdown

Línea de trabajo

El archivo que hay que cambiar es workshop/side-quest-11-06-anthropic-key.md; empieza por el párrafo introductorio, que enlaza muchos términos en línea, y por los pasos numerados que describen acciones de la interfaz o de la CLI. Reduce la introducción a dos oraciones, enlaza cada término solo en su primer uso y convierte las acciones en bloques de comandos breves, como gh secret set ANTHROPIC_API_KEY y el fragmento de frontmatter engine: claude. Está terminado cuando la lista de verificación sigue teniendo cinco elementos, el número de conceptos es de unos 15 o menos y npx --yes markdownlint-cli2 "**/*.md" pasa sin errores.

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.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
Lenguaje dominante
JavaScript
Estrellas
56
Forks
40
Merge medio
2 d 14 h
PR fusionados (30 d)
13

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.