[curriculum-eval] 04-github-actions-intro.md: cognitive_load — 28 new concepts in a "5 minutes" core-path step

Abierto Apto para principiantes
  • ¿Algo no está bien?
#5,252 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
66/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
github-actions, markdown
Área
documentation

Línea de trabajo

Empieza con workshop/04-github-actions-intro.md, leyendo la barrera de omisión, la sección “Etiquetar un workflow de ejemplo” y la lista de control de cinco elementos. Mueve los términos más allá de trigger, job, runner, action y step a un bloque plegable <details> titulado “Vocabulario adicional”. Convierte el etiquetado de trigger y job en un ejemplo resuelto, y los otros tres en una tarea para completar. Está terminado cuando los nuevos términos se limitan a esos cinco y el archivo pasa npx --yes markdownlint-cli2 "**/*.md".

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

Descripción

curriculum documentation quality

File: workshop/04-github-actions-intro.md
Overall Score: 5.4 / 10.0 (corpus mean: 6.1)

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 6.8 (756 words, 28 concepts) ≤ 15 concepts −3.2
active_learning 3.9 (density 1.19) ≥ 3 −6.1

(missing_checkpoint dismissed: 5-item checkpoint exists.)

Root Cause (≤ 2 sentences):
Word count is fine but 28 new concepts (trigger, job, runner, action, step, YAML keys, etc.) are introduced in a single early lesson. The sample workflow and "Explore a real workflow" tasks offer only 4 code blocks to anchor them.

Evidence (quoted from the file):

"Already know GitHub Actions? Confirm these three statements and skip ahead: You know workflows live in .github/workflows/ as YAML files..."

Learning Science Rationale:
Sweller's Cognitive Load Theory and the "expertise reversal" effect: novices need worked examples with fading guidance, while experts need to skip. The existing skip-gate is good; for novices, labelling all five parts at once exceeds working memory — a worked example of two parts followed by completion problems would lower intrinsic load.

Improvement Prompt (for an agent):

Edit workshop/04-github-actions-intro.md: keep the skip-gate. Reduce new terms to the five the checkpoint tests (trigger, job, runner, action, step) by moving other terminology into a collapsible <details> "Extra vocabulary" block. In "Label a sample workflow", fully label trigger and job as a worked example, then ask the learner to label the remaining three. Keep the :clipboard: Before You Start and checkpoint, second-person tone, no numbered headings. Run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: 6.2 / 10.0 (after the rubric regex fix: ~8.0)

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

  • expires on Nov 3, 2026, 3:33 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.