[curriculum-eval] side-quest-01-02-environment-reference.md: cognitive_load — 1433-word glossary with 17 concepts and low activity density

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

Hướng nghiên cứu

Đọc workshop/side-quest-01-02-environment-reference.md và tệp side-quest-enterprise-setup.md được liên kết, đồng thời tuân theo các quy ước trong AGENTS.md của repository. Gộp nội dung khái niệm trùng lặp về ảnh chụp màn hình vào bảng thuật ngữ, chuyển phần ánh xạ hostname Enterprise kèm theo một liên kết và thêm bốn bước kiểm tra lệnh. Giữ ít nhất bốn mục kiểm tra cụ thể trong mỗi phần được nêu tên; xác nhận tài liệu đáp ứng giới hạn về số từ và khái niệm, rồi chạy lệnh lint Markdown được yêu cầu.

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/side-quest-01-02-environment-reference.md
Overall Score: 4.9 / 10.0 (corpus mean: 6.1)

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 6.3 ≥ 8 (≤ 800 words, ≤ 15 concepts) −1.7 (1433 words, 17 concepts)
active_learning 2.1 ≥ 10 (density ≥ 3) −7.9 (density 0.63)
checkpoint_quality 0.0 (false positive, see note) 10 n/a
scaffolding 5.0 (likely false positive) 10 n/a

Note: the file does have ## :white_check_mark: Checkpoint (7 items) and ## :clipboard: Before You Start; the rubric regexes only recognise the emoji characters, not the shortcodes. The missing-checkpoint flag is dismissed. The length and activity-density flags are confirmed.

Root Cause (≤ 2 sentences):
The page is a reference glossary with a long "Conceptual screenshots" section (lines 54–154) that repeats the glossary and has only 2 code blocks, so words far outnumber learner actions.

Evidence (quoted from the file):

Environment and tool glossary ... ## Conceptual screenshots

Learning Science Rationale:
Sweller's Cognitive Load Theory predicts that long, passive reference material pushes extraneous load past working-memory limits, and Mayer's Redundancy Principle says duplicating the same information in text and graphics hurts learning. Splitting the glossary and the screenshots, and attaching small verification actions to each, lowers load and raises engagement.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md. Reduce it to ≤ 800 words and ≤ 15 distinct new concepts: merge the "Conceptual screenshots" section into the glossary (one image per tool, no duplicated prose) and move the enterprise hostname mapping into side-quest-enterprise-setup.md with a link. Add at least 4 short "run this command and confirm the output" code blocks (gh --version, git --version, gh aw --version, gh auth status). Keep the "Before You Start" and "## :white_check_mark: Checkpoint" sections with ≥ 4 specific items. Follow AGENTS.md conventions and run npx --yes markdownlint-cli2 "**/*.md".

Expected Score After Fix: 6.5 / 10.0 (rubric as implemented; about 8 once checkpoint detection is fixed)

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

  • expires on Nov 10, 2026, 3:33 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.