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

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

Hướng nghiên cứu

Bắt đầu với workshop/04-github-actions-intro.md và xem lại bảng thuật ngữ, Quick Refresher, hoạt động gắn nhãn, khối bỏ qua, mục Before You Start và checkpoint. Rút gọn các khái niệm của trang thành trigger, job, runner, action và step, rồi chuyển các thuật ngữ khác sang tài liệu GitHub Actions. Hoàn tất khi bảng thuật ngữ có năm hàng, các mục bắt buộc vẫn được giữ lại và checkpoint có ít nhất bốn mục.

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 ≥ 10 (≤ 15 concepts) −3.2 (28 concepts, 766 words)
active_learning 3.9 ≥ 10 (density ≥ 3) −6.1 (density 1.17)

(Note: checkpoint_quality = 0 is a scorer false positive; the page has a 5-item checkpoint.)

Root Cause (≤ 2 sentences):
A page titled "in 5 Minutes" introduces triggers, jobs, runners, actions, steps and more terminology (28 concepts) in a short word count, so density of new terms is the issue, not length. Most of the content is explanation followed by a single labeling exercise.

Evidence (quoted from the file):

"You know workflows live in .github/workflows/" / "You can read on, jobs, and steps keys in a workflow file" / "You know each step runs on a GitHub-hosted runner"

Learning Science Rationale:
Cognitive Load Theory's pre-training principle (Mayer) says key terms should be introduced before the main explanation. Presenting 28 terms inline competes for working memory; a short glossary table followed by the labeling activity reduces extraneous load.

Improvement Prompt (for an agent):

Edit workshop/04-github-actions-intro.md. Reduce new concepts to ≤ 15 by limiting the page to trigger, job, runner, action and step (the five the labeling exercise uses), and defer others to a link to the GitHub Actions docs. Add a 5-row glossary table before the "Quick Refresher", keep the "Already know Actions?" skip block, the "Before You Start" section and a ≥ 4-item "## :white_check_mark: Checkpoint". Run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: 6.0 / 10.0 (with scorer fix: 8.9)

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

  • expires on Nov 13, 2026, 5:04 AM UTC
Ngôn ngữ chính
JavaScript
Star
62
Fork
43
Merge trung bình
1 ngày 5 giờ
Pull request đã merge (30 ngày)
9

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.