[curriculum-eval] 04-github-actions-intro.md: cognitive_load — 28 new concepts in a 5-minute intro, low activity density

Abierto Apto para principiantes
#5,471 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
75/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
github-actions, markdown, yaml

Línea de trabajo

Empieza con workshop/04-github-actions-intro.md y revisa cómo presenta los conceptos de workflow, las actividades prácticas y su checkpoint. Compara la página con los límites indicados de 15 conceptos y una densidad de actividades de al menos 3 por cada 100 palabras; traslada los conceptos avanzados a la side quest indicada y añade una actividad, conservando las secciones y el tono especificados. Ejecuta el comando de markdownlint del issue y confirma que el checkpoint sigue teniendo al menos cuatro elementos.

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

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 6.8 ≥ 9 (≤ 800 words, ≤ 15 concepts) −2.2 (28 new concepts vs 15)
active_learning 3.9 ≥ 10 (density ≥ 3) −6.1
checkpoint_quality 0.0 (detector bug, see the checkpoint-detector issue; real checkpoint has 4 items) ≥ 10 n/a

Root Cause (≤ 2 sentences):
The page introduces 28 new concepts in 756 words (triggers, jobs, runners, actions, steps, plus agentic comparisons), nearly double the 15-concept benchmark. Only 5 checklist items and few code blocks give an activity density of 1.9 per 100 words.

Evidence (quoted from the file):

A GitHub Actions workflow is a YAML file in .github/workflows/ that tells GitHub: when to run (on), what to run (jobs), how each job executes (steps)

Learning Science Rationale:
Sweller's Cognitive Load Theory predicts that novices can hold only a few new elements in working memory; introducing 28 terms in one "5 minute" page before any hands-on practice raises intrinsic load and pushes learners toward passive reading. Chunking the vocabulary and interleaving each term with a short activity (worked-example effect) reduces load.

Improvement Prompt (for an agent):

Edit workshop/04-github-actions-intro.md. Reduce new concepts introduced to ≤ 15 by keeping only trigger, job, runner, action and step as taught terms and moving the rest into a link to side-quest-05-01-actions-power-user.md. Move the "Why This Matters for Agentic Workflows" comparison to a two-sentence NOTE-free paragraph. Add one more hands-on activity (a code block or checklist item the learner completes) so activity density reaches ≥ 3 per 100 words. Keep the "Already know GitHub Actions?" skip block, the "## :white_check_mark: Checkpoint" section with ≥ 4 items, second-person voice, no numbered headings. Run npx --yes markdownlint-cli2 "workshop/04-github-actions-intro.md".

Expected Score After Fix: 6.5 / 10.0 (≈ 8.4 once the checkpoint detector is fixed)

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

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