[curriculum-eval] 05-agentic-workflows-intro.md: style_compliance — duplicate Checkpoint heading and 1,107 words on an intro step

Cerrado Apto para principiantes
#5,293 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
62/100
Tipo de issue
Documentación
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
github-actions, markdown

Línea de trabajo

Empieza en workshop/05-agentic-workflows-intro.md y compara los dos encabezados ## :white_check_mark: Checkpoint de las líneas 120 y 138, conservando una lista de verificación y el enlace Next del recorrido. Luego recorta en unas 200 palabras el texto sobre los términos clave y remite a side-quest-05-03-two-file-structure.md para más detalle. Está terminado cuando solo quede un encabezado Checkpoint, el archivo tenga menos de unas 800 palabras y npx --yes markdownlint-cli2 "workshop/05-agentic-workflows-intro.md" pase sin errores.

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

Flagged Dimensions:

Dimension Score Benchmark Delta
active_learning 2.4 ≥ 10 (density ≥ 3) −7.6
cognitive_load 8.5 ≥ 9 (≤ 800 words) −0.5 (1,107 words)
structure two ## :white_check_mark: Checkpoint headings (lines 120 and 138) exactly one duplicate

Root Cause (≤ 2 sentences):
The page contains a second ## :white_check_mark: Checkpoint heading at line 138 after the first checklist and its "Still uncertain?" <details> block, so the section appears twice, and the 1,107 words of three activities with only six checklist items give a density of 2.4.

Evidence (quoted from the file):

:white_check_mark: Checkpoint
  • You can describe what an agentic workflow is in one sentence

(repeated again at line 138, directly before the <!-- journey: all --> Next link).

Learning Science Rationale:
A duplicated summary heading splits retrieval cues and weakens the testing effect (Roediger & Karpicke): learners cannot tell which list is authoritative, and extra text adds extraneous load (Sweller). Concise, one-per-step checkpoints keep the formative assessment predictable across the workshop.

Improvement Prompt (for an agent):

In workshop/05-agentic-workflows-intro.md, keep exactly one "## :white_check_mark: Checkpoint" section: merge the second heading at ~line 138 into the first (or delete it if it duplicates content), keeping the "Still uncertain?" details and the journey Next link after the single checklist. Then trim the "Three key terms" and "two-file structure" prose by ~200 words (defer detail to side-quest-05-03-two-file-structure.md) and add one runnable command or code block per activity so activity density is ≥ 3. Run `npx --yes markdownlint-cli2 "workshop/05-agentic-workflows-intro.md"`.

Expected Score After Fix: 6.5 / 10.0 (≈ 8.5 once the scorer detects the checkpoint)

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

  • expires on Nov 4, 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.