[curriculum-eval] 05-agentic-workflows-intro.md: active_learning — 1124 words with density 0.7 on a core-path step

Abierto Apto para principiantes
#5,780 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
87/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/05-agentic-workflows-intro.md y localiza la barrera para avanzar directamente, “Three key terms”, “The two-file structure” y las tres actividades. Reduce la página a 850 palabras como máximo y convierte al menos dos párrafos explicativos en pasos prácticos con un bloque de código o un comando. Mantén las secciones especificadas y evita los encabezados numerados; ejecuta npx --yes markdownlint-cli2 "**/*.md" y confirma que se supera la comprobación.

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

Descripción

curriculum documentation quality

File: workshop/05-agentic-workflows-intro.md
Overall Score: 5.39 / 10.0 (corpus mean: 6.06)

Flagged Dimensions:

Dimension Score Benchmark Delta
active_learning 2.3 ≥ 10 (density ≥ 3) −7.7
cognitive_load 8.4 ≥ 9 (≤ 800 words) −0.6 (1124 words)

(checkpoint_quality 0.0 and scaffolding 5.0 are rubric false positives.)

Root Cause (≤ 2 sentences):
This core-path concept step is ~40% over the word ideal, with three activities mostly prose-based and few code blocks. It also opens with a skip-ahead gate whose bullet criteria add words before the learner reaches content.

Evidence (quoted from the file):

Before skipping, confirm you already know both of these: You can describe what an Actions workflow trigger does; You have worked with AI agent execution environments in a production or CI/CD context

Learning Science Rationale:
Active-learning research (Freeman et al.) and Mayer's coherence principle suggest removing text that does not directly support the learning goal and replacing it with doing. Converting descriptive passages into short compile/inspect tasks raises engagement without extending the page.

Improvement Prompt (for an agent):

Edit workshop/05-agentic-workflows-intro.md. Trim it to ≤ 850 words by shortening the skip-ahead gate to one sentence and condensing "Three key terms" and "The two-file structure". Convert at least two explanatory paragraphs into hands-on steps with a code block or command each (for example viewing a .md frontmatter and its compiled .lock.yml). Keep the Before You Start section, the three activities, and the :white_check_mark: Checkpoint. Do not number headings. Run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: 6.3 / 10.0 with the current rubric.

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

  • expires on Nov 17, 2026, 3:38 AM UTC
Lenguaje dominante
JavaScript
Estrellas
62
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.