[curriculum-eval] 04-github-actions-intro.md: cognitive_load — 28 new concepts in a 766-word step

Đang mở Phù hợp với người mới
  • Có gì không ổn?
#5,579 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
74/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

Đọc workshop/04-github-actions-intro.md, tập trung vào các phần “Quick Refresher” và “Label a sample workflow”. Trước tiên, hãy kiểm tra bài tập yêu cầu những thuật ngữ nào và tài liệu hiện tại giới thiệu chúng ra sao. Công việc hoàn tất khi phần ôn tập được rút gọn còn những khái niệm cần thiết, các hoạt động ngắn được thêm vào giữa các nhóm khái niệm, đồng thời giữ nguyên các phần và phong cách đã chỉ định; hãy chạy lệnh markdownlint trong issue.

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 ≥ 9 (≤ 15 concepts) −2.2 (28 concepts)
active_learning 3.9 10 (density ≥ 3) −6.1
checkpoint_quality 0.0 (scorer false negative; heading at line 138) 10 n/a

Root Cause (≤ 2 sentences):
The "Quick Refresher" introduces roughly 28 Actions terms (workflow, job, step, runner, trigger, permissions, secrets, etc.) in one pass, nearly double the 15-concept ceiling. Hands-on activity only starts at "Label a sample workflow", after most of the vocabulary has been presented.

Evidence (quoted from the file):

Quick Refresher (line 26; followed by "Why This Matters for Agentic Workflows" at line 70 and "Label a sample workflow" at line 83)

Learning Science Rationale:
Miller/Cowan working-memory limits and Sweller's Cognitive Load Theory show that introducing many new terms before practice overloads intrinsic load. Mayer's pre-training principle suggests presenting only the few key terms needed first, then letting learners apply them in the labelling exercise and meeting the remaining terms in context.

Improvement Prompt (for an agent):

Edit workshop/04-github-actions-intro.md. Cut the Quick Refresher to the ≤ 12 terms needed for the "Label a sample workflow" exercise (workflow, trigger, job, step, runner, permissions, secret, etc.), moving the rest to a link to the official docs or a <details> block. Interleave a short action (a code block or checklist item) after each remaining concept group so activity density rises toward 3. Keep the ":clipboard: Before You Start" and "## :white_check_mark: Checkpoint" sections (≥ 4 items), second-person tone, no numbered headings. Run `npx --yes markdownlint-cli2 "workshop/04-github-actions-intro.md"`.

Expected Score After Fix: 7.8 / 10.0 (with the rubric regex fix; ~6.0 with current scorer)

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

  • expires on Nov 12, 2026, 3:03 AM UTC
Ngôn ngữ chính
JavaScript
Star
58
Fork
40
Merge trung bình
1 ngày 22 giờ
Pull request đã merge (30 ngày)
7

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.