[curriculum-eval] 04-github-actions-intro.md: cognitive_load — 28 new concepts in a "5 minutes" core-path step

Đã đóng Phù hợp với người mới
  • Có gì không ổn?
#5,252 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
66/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
github-actions, markdown
Lĩnh vực
documentation

Hướng nghiên cứu

Bắt đầu từ workshop/04-github-actions-intro.md, đọc cổng bỏ qua, mục “Gắn nhãn một workflow mẫu” và danh sách kiểm tra năm mục. Chuyển các thuật ngữ ngoài trigger, job, runner, action và step vào một khối thu gọn <details> có tiêu đề “Từ vựng bổ sung”. Biến việc gắn nhãn trigger và job thành một ví dụ có hướng dẫn, còn ba mục còn lại thành nhiệm vụ để hoàn thành. Hoàn tất khi các thuật ngữ mới chỉ giới hạn trong năm từ đó và tệp vượt qua npx --yes markdownlint-cli2 "**/*.md".

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: workshop/04-github-actions-intro.md
Overall Score: 5.4 / 10.0 (corpus mean: 6.1)

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 6.8 (756 words, 28 concepts) ≤ 15 concepts −3.2
active_learning 3.9 (density 1.19) ≥ 3 −6.1

(missing_checkpoint dismissed: 5-item checkpoint exists.)

Root Cause (≤ 2 sentences):
Word count is fine but 28 new concepts (trigger, job, runner, action, step, YAML keys, etc.) are introduced in a single early lesson. The sample workflow and "Explore a real workflow" tasks offer only 4 code blocks to anchor them.

Evidence (quoted from the file):

"Already know GitHub Actions? Confirm these three statements and skip ahead: You know workflows live in .github/workflows/ as YAML files..."

Learning Science Rationale:
Sweller's Cognitive Load Theory and the "expertise reversal" effect: novices need worked examples with fading guidance, while experts need to skip. The existing skip-gate is good; for novices, labelling all five parts at once exceeds working memory — a worked example of two parts followed by completion problems would lower intrinsic load.

Improvement Prompt (for an agent):

Edit workshop/04-github-actions-intro.md: keep the skip-gate. Reduce new terms to the five the checkpoint tests (trigger, job, runner, action, step) by moving other terminology into a collapsible <details> "Extra vocabulary" block. In "Label a sample workflow", fully label trigger and job as a worked example, then ask the learner to label the remaining three. Keep the :clipboard: Before You Start and checkpoint, second-person tone, no numbered headings. Run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: 6.2 / 10.0 (after the rubric regex fix: ~8.0)

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

  • expires on Nov 3, 2026, 3:33 AM UTC
Ngôn ngữ chính
JavaScript
Star
56
Fork
40
Merge trung bình
2 ngày 14 giờ
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.