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

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

Línea de trabajo

Empieza con workshop/04-github-actions-intro.md y revisa Quick Refresher, la actividad de ejemplo de workflow y el checkpoint. Compara los conceptos introducidos con el objetivo de 15 conceptos del issue y consulta workshop/side-quest-05-01-actions-power-user.md para ver los detalles cuyo traslado se propone. El trabajo estará terminado cuando el repaso se limite a on/jobs/steps, la actividad vaya a continuación y el checkpoint tenga 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.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 ≥ 3 → 10 -6.1

Root Cause (≤ 2 sentences):
The step introduces trigger, job, runner, action, step, on, jobs, steps, etc. plus a bridge to agentic workflows — nearly double the concept budget. This is a core-path lesson where learners are least equipped to chunk the vocabulary.

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:
Miller/Sweller limits on working memory predict that introducing ~28 elements in one step overloads novices; Mayer's segmenting principle suggests presenting vocabulary in smaller chunks tied to an immediate activity, so each term is anchored by use before the next arrives.

Improvement Prompt (for an agent):

Edit workshop/04-github-actions-intro.md: reduce new concepts to ≤ 15 by limiting the "Quick Refresher" to on/jobs/steps and moving runner/action/matrix-style detail to a link or side quest (workshop/side-quest-05-01-actions-power-user.md). Place the "Label a sample workflow" activity directly after the refresher. Keep the ":white_check_mark: Checkpoint" with ≥ 4 verifiable items, keep headings unnumbered, and run npx --yes markdownlint-cli2 "**/*.md".

Expected Score After Fix: 6.5 / 10.0 (before scorer fix)

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

  • expires on Nov 10, 2026, 4:04 AM UTC
Lenguaje dominante
JavaScript
Estrellas
58
Forks
40
Merge medio
1 d 22 h
PR fusionados (30 d)
7

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.