[curriculum-eval] curriculum_assessment.py: checkpoint_quality — regex misses :white_check_mark: and :clipboard: shortcodes

Ouverte Adaptée aux débutants
#6,000 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
80/100
Type d'issue
Bug
Clarté
Clairement spécifiée
Activité
Active
Stack technique
python
Domaine
tooling

Piste de recherche

Commence dans .github/skills/curriculum-quantitative-assessment/curriculum_assessment.py à la définition de CHECKPOINT_RE, puis suis chaque endroit où cette famille de motifs est réutilisée : la regex has_prereq_section, le compteur d’éléments de liste de contrôle et l’indice Bloom activity:checkpoint. Fais correspondre à la fois l’emoji littéral et les formes de shortcode :white_check_mark: / :clipboard:, puis relance l’évaluation sur workshop/*.md et confirme que workshop/04-github-actions-intro.md rapporte has_checkpoint: true avec scaffolding 10, ainsi que la nouvelle moyenne du corpus.

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 (affects all workshop/*.md)
Overall Score: 5.4 / 10.0 for the 5 flagged pages (corpus mean: 6.06)

Flagged Dimensions:

Dimension Score Benchmark Delta
checkpoint_quality 0.0 ≥ 10.0 (≥ 4 items) −10.0
scaffolding 5.0 10.0 −5.0

Root Cause (≤ 2 sentences):
CHECKPOINT_RE = r"##\s+✅\s*Checkpoint" and the prerequisite regex ##\s+📋\s*Before You Start require literal emoji, but the workshop writes ## :white_check_mark: Checkpoint and ## :clipboard: Before You Start. Every flagged page reports has_checkpoint: false and checkpoint_quality: 0.0 even when it has 5–7 checklist items.

Evidence (quoted from the file):

## :white_check_mark: Checkpoint / - [ ] You labeled all five parts of the sample workflow above ... (workshop/04-github-actions-intro.md, lines 138–144), which the scorer reports as has_checkpoint: false.

Learning Science Rationale:
Valid assessment depends on instruments that measure the intended construct. A false 0 for checkpoint quality pushes learners' retrieval-practice checkpoints, which are the strongest formative-assessment signal in the lesson, out of view, and sends authors to fix content that is not broken. Fixing the scorer restores a reliable feedback loop for Bloom-aligned improvements.

Improvement Prompt (for an agent):

In .github/skills/curriculum-quantitative-assessment/curriculum_assessment.py, update CHECKPOINT_RE to match both the literal emoji and the shortcode form (e.g. r"##\s+(?:✅|:white_check_mark:)\s*Checkpoint", re.IGNORECASE), and update the has_prereq_section regex to match "## 📋 Before You Start" and "## :clipboard: Before You Start" as well as "## Prerequisites". Also check the checklist-item counting and the "activity:checkpoint" Bloom cue use the same pattern. Re-run the assessment, confirm that 04-github-actions-intro.md now has has_checkpoint=true and scaffolding=10, and report the new corpus mean and the updated findings list.

Expected Score After Fix: 6.9 / 10.0 for 04-github-actions-intro.md (corpus mean expected to rise by roughly 1–2 points)

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

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