[curriculum-eval] 05-agentic-workflows-intro.md: active_learning — 1107 words, 2.4 score for activity density

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

Línea de trabajo

Read workshop/05-agentic-workflows-intro.md and review its word count, activities, Before You Start section, and Checkpoint. Follow the improvement prompt: shorten the key terms, move the specified explanations into a <details> block, and make Activities 2 and 3 checklist driven with concrete outputs. Done when the page is at most 850 words and preserves the required sections; run the provided markdownlint command.

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.4 / 10.0 (corpus mean: 6.1)

Flagged Dimensions:

Dimension Score Benchmark Delta
active_learning 2.4 ≥ 10 −7.6
cognitive_load ≈ 7.0 (above 800 words) ≥ 9 ≈ −2 (1107 words)

Root Cause (≤ 2 sentences):
This foundational page (three key terms, two-file structure, and three activities) runs 1107 words, ~55% over the 800-word ideal, with activity density only ~0.8 per 100 words. The activities are prose-heavy (classification and brief-writing) with little code or checklist interaction.

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:
Mayer's segmenting and signalling principles suggest chunking dense explanations and cueing the learner to the essential elements; Cognitive Load Theory predicts that exceeding ~800 words of mixed explanation and activity taxes working memory in an introductory step. Shorter segments with immediate practice improve retention (the testing effect).

Improvement Prompt (for an agent):

Edit workshop/05-agentic-workflows-intro.md. Cut it to ≤ 850 words: shorten "Three key terms" to a three-row table, and move the "Still uncertain?" reveal and extended explanation of the two-file structure into a <details> block. Keep Activity 2 and Activity 3 but turn each into a short checklist-driven task with a concrete expected output (so activity density ≥ 3). Preserve Before You Start and the 6-item Checkpoint. No numbered headings (rename "Activity 2 —" / "Activity 3 —" to descriptive headings). Run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: 5.9 / 10.0 with current rubric (≈ 7.7 after the rubric regex fix)

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

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