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

Cerrado Apto para principiantes
#5,320 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 3 días

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
77/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
github-actions, javascript, markdown

Línea de trabajo

Empieza con workshop/04-github-actions-intro.md y compara el Quick Refresher, el ejercicio de etiquetado y la exploración del workflow con los cinco términos clave del issue. Simplifica el vocabulario y añade una actividad práctica, conservando las secciones con nombre Checkpoint y Before You Start. La tarea estará terminada cuando la página reduzca los conceptos y aumente las actividades tal como se describe; ejecuta 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.39 / 10.0 (corpus mean: 6.06)

Flagged Dimensions:

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

(checkpoint_quality 0.0 / scaffolding 5.0 are rubric false negatives — the page has ## :white_check_mark: Checkpoint with 5 items and ## :clipboard: Before You Start.)

Root Cause (≤ 2 sentences):
The page is titled "GitHub Actions in 5 Minutes" but introduces 28 distinct terms (trigger, job, runner, action, step, on, jobs, steps, etc.) across 7 sections. Confirmed: the Quick Refresher plus labeling exercise plus a real-workflow exploration is more than five minutes of new vocabulary.

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 / You can read on, jobs, and steps keys in a workflow file

Learning Science Rationale:
Miller/Cowan working-memory limits and Sweller's Cognitive Load Theory predict that more than ~4–7 novel elements at once overwhelms novices. Pre-training (Mayer) — introducing the five key terms first, then examples — reduces intrinsic load, and worked examples with faded guidance help novices connect the terms.

Improvement Prompt (for an agent):

Edit workshop/04-github-actions-intro.md. Reduce new concepts to ≤ 15 by limiting the Quick Refresher to the five parts used in the labeling exercise (trigger, job, runner, action, step), moving optional terms (e.g. `on`/`jobs`/`steps` syntax detail, extra definitions) to a <details> block or an existing side-quest, and replacing long prose with a one-line definition table. Add one more hands-on item (e.g. a code block the learner edits) so activity density rises toward 3. Keep the `:white_check_mark: Checkpoint` (≥ 4 specific items) and `:clipboard: Before You Start`. Run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: 6.2 / 10.0 (≈ 8.3 once the rubric regex is fixed)

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

  • expires on Nov 5, 2026, 4:05 AM UTC
Lenguaje dominante
JavaScript
Estrellas
58
Forks
40
Merge medio
4 d 4 h
PR fusionados (30 d)
8

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.