[curriculum-eval] curriculum_assessment.py: checkpoint_quality and scaffolding — regexes miss :shortcode: headings

Cerrado Apto para principiantes
  • ¿Algo no está bien?
#5,297 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
72/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
github-actions, markdown, python
Área
tooling

Línea de trabajo

Empieza en .github/skills/curriculum-quantitative-assessment/curriculum_assessment.py y localiza CHECKPOINT_RE y la expresión regular de Before-You-Start, que solo coinciden con emojis literales. Amplíalas para que acepten los shortcodes ✅ y 📋, incluida la detección de bloom 'activity:checkpoint'. Está terminado cuando workshop/04-github-actions-intro.md obtenga checkpoint_quality ≥ 10 y scaffolding 10 en una nueva ejecución sobre workshop/.

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

Descripción

curriculum documentation quality

File: .github/skills/curriculum-quantitative-assessment/curriculum_assessment.py
Overall Score: n/a (rubric tooling; corpus mean 6.06)

Flagged Dimensions:

Dimension Score Benchmark Delta
checkpoint_quality 0.0 (92 of 94 files) ≥ 7.5 ≈ −7.5
scaffolding 5.0 (understated) 10 when present −5

Root Cause (≤ 2 sentences):
CHECKPOINT_RE = r"##\s+✅\s*Checkpoint" and the Before-You-Start regex ##\s+📋\s*Before You Start match literal emoji, but workshop files use :white_check_mark: and :clipboard: shortcodes. Every checkpoint and scaffolding section is therefore reported as missing, which drags down scores and produces false missing_checkpoint findings.

Evidence (quoted from the file):

workshop/04-github-actions-intro.md: ## :white_check_mark: Checkpoint followed by 5 checklist items, and ## :clipboard: Before You Start — yet scored checkpoint_quality: 0.0, scaffolding: 5.0.

Learning Science Rationale:
Valid measurement is a precondition for acting on scores. Formative-assessment research (Black & Wiliam) shows checkpoints support retrieval practice and self-monitoring. A rubric that reports them as absent misdirects authors toward adding content that already exists and hides real gaps.

Improvement Prompt (for an agent):

In .github/skills/curriculum-quantitative-assessment/curriculum_assessment.py, update CHECKPOINT_RE and the has_prereq_section regex so they match both the literal emoji (✅, 📋) and GitHub shortcodes (:white_check_mark:, :clipboard:). Example: r"##\s+(?:✅|:white_check_mark:)\s*Checkpoint". Also update the bloom 'activity:checkpoint' detection that uses CHECKPOINT_RE. Add/adjust tests if present, rerun the assessment on workshop/, and confirm 04-github-actions-intro.md now gets checkpoint_quality ≥ 10 and scaffolding = 10.

Expected Score After Fix: ~7.0 / 10.0 corpus mean (from 6.06)

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

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