[curriculum-eval] curriculum_assessment.py: checkpoint_quality — regex misses :white_check_mark: shortcode, deflating scores corpus-wide

Ouverte Adaptée aux débutants
#5,972 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

Personne n'a encore pris cette issue.

Évaluation

Difficulté
2/5
Temps estimé
1-3 heures
Accessibilité débutants
78/100
Type d'issue
Bug
Clarté
Clairement spécifiée
Activité
Active
Stack technique
python
Domaine
tooling

Piste de recherche

Ouvre .github/skills/curriculum-quantitative-assessment/curriculum_assessment.py et trouve les deux motifs au niveau du module CHECKPOINT_RE et la regex des prérequis ; les deux ne correspondent actuellement qu'aux formes emoji. Élargis chaque motif pour accepter aussi le texte shortcode :white_check_mark: et :clipboard: comme indiqué dans le prompt d'amélioration, puis relance l'évaluation sur workshop/. Terminé lorsque workshop/04-github-actions-intro.md rapporte has_checkpoint=true, side-quest-01-02-environment-reference.md rapporte has_prereq_section=true, et que les constats missing_checkpoint restants ne concernent que des pages qui manquent réellement d'un checkpoint.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

curriculum documentation quality

File: .github/skills/curriculum-quantitative-assessment/curriculum_assessment.py
Overall Score: 6.06 / 10.0 corpus mean (lowest page: 4.79)

Flagged Dimensions:

Dimension Score Benchmark Delta
checkpoint_quality 0.0 on 93/95 learning pages present, ≥ 4 items (10.0) −10.0
scaffolding 5.0 on pages using :clipboard: Before You Start 10.0 −5.0

Root Cause (≤ 2 sentences):
CHECKPOINT_RE is ##\s+✅\s*Checkpoint and the scaffolding regex is ##\s+📋\s*Before You Start, but workshop pages (per repo conventions) write ## :white_check_mark: Checkpoint and ## :clipboard: Before You Start. Result: has_checkpoint=false and has_prereq_section=false for nearly every page, so weights 2.0 + 1.5 are scored as failures and all missing_checkpoint findings are false positives.

Evidence (quoted from the file):

CHECKPOINT_RE = re.compile(r"##\s+✅\s*Checkpoint", re.IGNORECASE) versus workshop/04-github-actions-intro.md line 138: ## :white_check_mark: Checkpoint (followed by 5 checklist items), and side-quest-01-02-environment-reference.md line 9: ## :clipboard: Before You Start.

Learning Science Rationale:
Valid measurement is a precondition for acting on Bloom's/Cognitive Load findings: a rubric that scores retrieval-practice checkpoints (Roediger & Karpicke's testing effect) as absent when they exist misdirects improvement effort and hides the real differentiators (word count, concept load, activity density). Fixing the instrument restores the signal so remaining findings reflect genuine content gaps.

Improvement Prompt (for an agent):

In .github/skills/curriculum-quantitative-assessment/curriculum_assessment.py, update CHECKPOINT_RE to match both "## ✅ Checkpoint" and "## :white_check_mark: Checkpoint" (e.g. r"##\s+(?:✅|:white_check_mark:)\s*Checkpoint"), and update the has_prereq_section regex so "## :clipboard: Before You Start" matches as well as "## 📋 Before You Start" and "## Prerequisites". Re-run the assessment on workshop/ and confirm that pages like 04-github-actions-intro.md now report has_checkpoint=true and has_prereq_section=true, that the corpus mean rises, and that "missing_checkpoint" flags drop to only pages genuinely lacking a checkpoint. Do not edit workshop content.

Expected Score After Fix: ~7.5 / 10.0 corpus mean (checkpoint and scaffolding dimensions recover for most pages)

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

  • expires on Nov 22, 2026, 7:05 AM UTC
Langage dominant
JavaScript
Étoiles
61
Forks
43
Merge moyen
10 h 38 min
PR mergées (30 j)
12

Préparer son environnement

Ouvrir dans Codespaces

Lance le conteneur de développement du projet dans votre navigateur, avec votre propre compte GitHub.

  • Aucun Dockerfile ni fichier Docker Compose
  • Aucun modèle de pull request
  • Aucun guide de contribution

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de githubnext/gh-aw-workshop

Toutes les issues de githubnext/gh-aw-workshop

Issues similaires

Plus d'issues JavaScript

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.