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

Đang mở Phù hợp với người mới
  • Có gì không ổn?
#5,433 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 3 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
76/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à xác định các phần tham khảo công cụ dài nhất cùng những cơ hội để người học thực hành. Rút gọn trang còn 900 từ hoặc ít hơn, thêm hai bước học tập chủ động và giữ lại các phần Before You Start và Checkpoint. Nếu thêm tệp side quest, hãy cập nhật workshop/README.md; khi hoàn tất, chạy lệnh markdownlint được chỉ định.

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 ≥ 9 (≤ 800 words, ≤ 15 concepts) −2.7+ (1433 words, 17 concepts)
active_learning 2.1 ≥ 10 (density ≥ 3) −7.9 (density 0.63)

(checkpoint/scaffolding zeros are a regex artefact, see the rubric issue; the page does have both sections.)

Root Cause (≤ 2 sentences):
The page packs ~9 tools and environments into one 1433-word reference (almost 2× the corpus median), with only 2 code blocks and 7 checklist items. A single scroll of glossary entries has no practice between concepts.

Evidence (quoted from the file):

"This is a reference page — you can read it any time. Come back here whenever the workshop uses a term you want to clarify."

Learning Science Rationale:
Sweller's Cognitive Load Theory predicts that presenting many unrelated elements at once exceeds working memory; Mayer's segmenting principle recommends splitting content into learner-paced chunks. A long glossary with little interaction encourages passive reading rather than retrieval practice.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md. Reduce it to ≤ 900 words by (1) splitting the "Workshop tools and model options" section (gh, gh-aw, Copilot CLI, Copilot app, Claude, OpenAI Codex) into a new side quest file or collapsing each entry into a one-line summary inside a table, and (2) wrapping secondary detail in <details>. Add two short active-learning steps, e.g. "run `gh --version` and note the output" and a match-the-tool-to-its-role mini quiz. Keep the Before You Start and Checkpoint sections, keep headings unnumbered, update workshop/README.md if a file is added, and run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: 5.5 / 10.0 with current rubric (≈ 7.3 after the rubric regex fix)

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

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

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.