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

Đang mở Phù hợp với người mới
#5,548 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, github-actions, markdown
Lĩnh vực
content, documentation

Hướng nghiên cứu

Đọc workshop/side-quest-01-02-environment-reference.md, tập trung vào “Workshop tools and model options” và “Verify your tools are ready”; kiểm tra số từ hiện tại và mật độ hoạt động xác minh. Tách phần nội dung về công cụ thành một nhiệm vụ phụ có liên kết hoặc cô đọng thành các khối details, đồng thời giữ lại phần xác minh và Checkpoint. Nếu thêm trang, hãy cập nhật workshop/README.md, sau đó chạy npx --yes markdownlint-cli2 "**/*.md"; hoàn tất khi trang chính đạt các mục tiêu về số từ và khái niệm đã nêu, đồng thời có hai lệnh xác minh.

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 ≥ 7 (density ≥ 3) −4.9 (density 0.63)

Root Cause (≤ 2 sentences):
One page defines ~10 tools and environments (Codespaces, VS Code, terminal, gh, gh-aw, Copilot CLI, Copilot app, Claude, Codex) each with a "conceptual screenshot", nearly doubling the word budget. Only one short verification block provides hands-on activity. (The "missing checkpoint" flag is a scorer false positive; the page has a Checkpoint.)

Evidence (quoted from the file):

## Conceptual screenshots ... #### OpenAI Codex — "You may see OpenAI Codex as a coding-focused model option that reads files and suggests ed..."

Learning Science Rationale:
Sweller's Cognitive Load Theory predicts that presenting many novel elements at once overloads working memory, and Mayer's segmenting principle recommends splitting long multimedia explanations into learner-paced chunks. Splitting reference material into a short core and optional per-tool pages lets learners verify only what they need.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md. Keep the "Verify your tools are ready" section and Checkpoint on this page. Split the "Workshop tools and model options" section (gh, gh-aw, Copilot CLI, Copilot app, Claude, OpenAI Codex) into a new side-quest page, linking to it from the original, or collapse each tool into a <details> block with a 2-sentence summary. Target ≤ 800 words and ≤ 15 concepts on the main page, add two verification commands (e.g. `gh auth status`, `gh extension list`) to raise activity density to ≥ 3. Update workshop/README.md if a page is added, and run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: 5.5 / 10.0 with current rubric (≈ 8 once checkpoint regex is fixed)

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

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