[curriculum-eval] curriculum_assessment.py: checkpoint_quality — regexes miss `:white_check_mark:` and `:clipboard:` headings, depressing 93 pages

Đang mở Phù hợp với người mới
#5,776 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
88/100
Loại issue
Lỗi
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
github-actions, python
Lĩnh vực
testing

Hướng nghiên cứu

Bắt đầu với .github/skills/curriculum-quantitative-assessment/curriculum_assessment.py, nơi issue chỉ ra CHECKPOINT_RE và biểu thức chính quy cho phần điều kiện tiên quyết. Đọc các mẫu đó và kiểm tra tiêu đề ví dụ trong workshop/04-github-actions-intro.md. Cập nhật cả hai mẫu để nhận dạng các dạng emoji và shortcode, đồng thời giữ nguyên ## Prerequisites; sau đó chạy lại quy trình đánh giá và kiểm tra kết quả checkpoint cùng giá trị trung bình của corpus được báo cáo.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

curriculum documentation quality

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

Flagged Dimensions:

Dimension Score Benchmark Delta
checkpoint_quality 0.0 on 93/95 pages ≥ 4 items → 10 −10
scaffolding 5.0 on 95/95 pages section present → 10 −5

Root Cause (≤ 2 sentences):
CHECKPOINT_RE matches only the literal ✅ emoji and the prerequisite check matches only 📋. Workshop pages use the GitHub shortcode form (## :white_check_mark: Checkpoint, ## :clipboard: Before You Start), so every page scores 0 for checkpoint and 5 for scaffolding.

Evidence (quoted from the file):

CHECKPOINT_RE = re.compile(r"##\s+✅\s*Checkpoint", re.IGNORECASE) and re.search(r"##\s+📋\s*Before You Start", raw, re.IGNORECASE)

For example, workshop/04-github-actions-intro.md has ## :white_check_mark: Checkpoint with 5 checklist items but is reported has_checkpoint: false. 93 workshop files contain that exact heading.

Learning Science Rationale:
Retrieval practice and formative assessment (Roediger & Karpicke) require learners to self-check outcomes at the end of a step, and the workshop already provides this. A rubric that cannot see it produces false "missing checkpoint" findings, hides real weaknesses (length, concept overload, low activity density) and wastes remediation effort on content that is already correct.

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", and update the has_prereq_section regex to match both "## 📋 Before You Start" and "## :clipboard: Before You Start" (keep "## Prerequisites"). Use patterns like r"##\s+(?:✅|:white_check_mark:)\s*Checkpoint" and r"##\s+(?:📋|:clipboard:)\s*Before You Start". Re-run the assessment and confirm that has_checkpoint is true for all pages except 00-welcome, 01-prerequisites, 06-install-gh-aw and README, and that the corpus mean rises by about 2 points.

Expected Score After Fix: 8.0 / 10.0 (corpus mean; most pages gain +2.0 checkpoint and +0.75 scaffolding)

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

  • expires on Nov 17, 2026, 3:03 AM UTC
Ngôn ngữ chính
JavaScript
Star
62
Fork
43
Merge trung bình
11 giờ 26 phút
Pull request đã merge (30 ngày)
13

Chuẩn bị môi trường

Mở trong Codespaces

Khởi chạy dev container của dự án ngay trên trình duyệt, bằng tài khoản GitHub của bạn.

  • Không có Dockerfile hay tệp Docker Compose
  • Không có mẫu pull request
  • Không có hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của githubnext/gh-aw-workshop

Tất cả issue của githubnext/gh-aw-workshop

Issue tương tự

Thêm issue về JavaScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.