[curriculum-eval] 05-agentic-workflows-intro.md: active_learning — 1,107 words with density 0.72

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

Línea de trabajo

Empieza con workshop/05-agentic-workflows-intro.md y revisa sus tres actividades, la consigna de predicción, el diagrama de dos archivos y el Checkpoint. Recorta unas 200 palabras, conservando los tres términos clave y los elementos obligatorios. Después, añade una actividad práctica breve. Ejecuta el comando markdownlint especificado; el trabajo estará terminado cuando se ejecute correctamente y la página cumpla las restricciones de contenido y formato indicadas.

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 (density 0.72) ≥ 3 density (score 10) −7.6
cognitive_load 8.5 (1,107 words, 15 concepts) ≤ 800 words −1.5

(missing_checkpoint dismissed: the page has a 6-item Checkpoint; scorer false positive.)

Root Cause (≤ 2 sentences):
This is the first conceptual step for agentic workflows and is ~40% over the word benchmark, with only two code blocks and six checklist items. Three activities exist, but explanatory text between them dilutes activity density.

Evidence (quoted from the file):

"Before studying the diagram, write your prediction: what two files are involved, and which one does GitHub Actions actually run?"

Learning Science Rationale:
Active-learning research (Freeman et al.) and Bloom's Understand level call for learners to generate explanations, not just read them. The prediction prompt above is a good generative activity; the page needs more of them and fewer paragraphs, as Mayer's coherence principle suggests trimming content that does not support the learning goal.

Improvement Prompt (for an agent):

Edit workshop/05-agentic-workflows-intro.md: trim prose by ~200 words (target ≤ 900) without removing the three key terms, the two-file diagram, or the three activities. Add one short hands-on element, for example a bash block that lists `.github/workflows/` and a prompt to identify the `.md` vs `.lock.yml` file. Keep the existing prediction prompt, the :clipboard: Before You Start and the Checkpoint with ≥ 4 items; keep ≤ 3 callouts and no numbered headings. Run `npx --yes markdownlint-cli2 "workshop/05-agentic-workflows-intro.md"`.

Expected Score After Fix: 5.9 / 10.0 with current scorer (≈ 8.4 after the scorer fix)

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

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