Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

[curriculum-eval] 04-github-actions-intro.md: cognitive_load — 28 new concepts in an introductory step

Đã đóng Phù hợp với người mới
  • Có gì không ổn?
#4,745 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
72/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, javascript, markdown
Lĩnh vực
content, documentation

Hướng nghiên cứu

Đọc workshop/04-github-actions-intro.md và tệp side-quest-05-01-actions-power-user.md được liên kết; làm theo hướng dẫn dành cho kho lưu trữ trong AGENTS.md. Rút gọn phần ôn tập còn năm khái niệm được dùng trong hoạt động gắn nhãn, chuyển các khái niệm còn lại sang nhiệm vụ phụ kèm một liên kết, thêm một bài thực hành ngắn và giữ lại ít nhất bốn mục kiểm tra. Chạy npx --yes markdownlint-cli2 "**/*.md"; hoàn tất khi các chỉnh sửa được yêu cầu đáp ứng tiêu chí đánh giá và lint chạy thành công.

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.39 / 10.0 (corpus mean: 6.09)

Flagged Dimensions:

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

Root Cause (≤ 2 sentences):
The core-path intro introduces 28 distinct concepts (events, jobs, runners, steps, actions, YAML syntax, etc.) before learners practice, which exceeds the 15-concept guideline.

Evidence (quoted from the file):

Quick Refresher (workshop/04-github-actions-intro.md, line 26) — followed by a full annotated workflow before the labeling activity

Learning Science Rationale:
Cognitive Load Theory and the pre-training principle (Mayer) suggest teaching key terms first and in small sets; limiting new elements to ~7±2 per segment prevents novices (the target audience for step 4) being overloaded.

Improvement Prompt (for an agent):

Edit workshop/04-github-actions-intro.md. Reduce new concepts to ≤ 15 by limiting the Quick Refresher to the five parts used in the labeling activity (trigger, job, runner, action, step) and moving everything else (matrix, expressions, secrets, etc.) to side-quest-05-01-actions-power-user.md via a link. Add one extra short hands-on task with a code block. Keep Checkpoint (≥ 4 items). Follow AGENTS.md, run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: ≈ 6.2 / 10.0

Generated by 🔬 Curriculum Quality Evaluator · copilot · auto · 32.3 AIC · ⌖ 0.79 AIC · ⊞ 10.5K · ◷

  • expires on Oct 20, 2026, 2:48 AM UTC
Ngôn ngữ chính
JavaScript
Star
55
Fork
36
Merge trung bình
2 ngày 18 giờ
Pull request đã merge (30 ngày)
14

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.