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

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

Línea de trabajo

Lee workshop/04-github-actions-intro.md y céntrate en el Quick Refresher, el YAML anotado, “Why This Matters” y el ejercicio de etiquetado. Comprueba cómo se presentan los cinco términos fundamentales y dónde aparecen los conceptos y enlaces adicionales. La tarea estará completada cuando la página se limite a esos cinco términos y conserve los detalles para avanzar directamente, la sección Before You Start, la actividad de etiquetado y un punto de control con al menos cuatro elementos verificables.

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 ≤ 15 concepts (actual 28; 766 words) −3.2
active_learning 3.9 density ≥ 3 (actual 1.17) −6.1
checkpoint_quality 0.0 (false positive: 5-item checkpoint exists) ≥ 4 items n/a

Root Cause (≤ 2 sentences):
Core path step for newcomers: the Quick Refresher, annotated YAML, "Why This Matters" and labelling exercise introduce 28 distinct terms (trigger, job, runner, step, action, on, jobs, steps, ...) in 766 words. Word count is fine; concept density is the problem.

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/Sweller working-memory limits mean novices can handle only a handful of new elements at once. Reducing element interactivity by teaching five core terms (trigger, job, runner, action, step) and deferring the rest helps schema formation before the labelling activity.

Improvement Prompt (for an agent):

Edit workshop/04-github-actions-intro.md. Reduce new concepts to ≤ 15 by restricting the page to five terms: trigger, job, runner, action, step. Move extra terms/links (expressions, secrets, matrix, etc.) out or into a single "Learn more" line. Keep the skip-ahead details block, the Before You Start section, the labelling activity and the Checkpoint (≥ 4 verifiable items). No numbered headings; run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: 5.9 / 10.0 (≈ 7.9 once the checkpoint regex is fixed)

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

  • expires on Nov 20, 2026, 8:04 AM UTC
Lenguaje dominante
JavaScript
Estrellas
61
Forks
43
Merge medio
11 h 26 min
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.