[curriculum-eval] side-quest-01-02-environment-reference.md: cognitive_load — 1433-word glossary plus screenshots, low activity density

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

Bắt đầu với workshop/side-quest-01-02-environment-reference.md và rà soát bảng thuật ngữ cùng phần “Conceptual screenshots” theo các mục tiêu về độ dài và mật độ hoạt động trong issue. Giữ lại các phần có tên về checkpoint và những việc cần làm trước khi bắt đầu, đồng thời thêm các lệnh thực hành ngắn kèm đầu ra dự kiến. Nếu thêm tệp side quest, hãy cập nhật workshop/README.md; issue cũng yêu cầu chạy markdownlint trên tất cả các tệp Markdown.

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

(checkpoint_quality/scaffolding flags are scorer false positives; see the rubric-bug issue.)

Root Cause (≤ 2 sentences):
A single page packs a large glossary table and a "Conceptual screenshots" section totalling ~1.8× the word target, with only 2 code blocks. Reference content is delivered as one block rather than looked up on demand.

Evidence (quoted from the file):

Knowing which name maps to which role helps you follow workshop instructions without stopping to wonder what "the terminal" or "Codespaces" means in context.

Learning Science Rationale:
Sweller's Cognitive Load Theory predicts that extraneous load rises when learners must hold many unrelated terms in working memory at once; Mayer's segmenting and signaling principles recommend splitting dense material into learner-paced chunks. A reference page that is also a lesson blurs both purposes.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md: reduce it to ≤ 800 words by splitting the "Conceptual screenshots" section into a separate side quest (or trimming to the 3 most important environments), keep the glossary table concise, and add 2–3 short hands-on commands with expected output (e.g. gh --version, git --version) to raise activity density. Keep the `## :white_check_mark: Checkpoint` and `## :clipboard: Before You Start` sections, do not number headings, update workshop/README.md if a file is added, and run npx --yes markdownlint-cli2 "**/*.md".

Expected Score After Fix: 6.5 / 10.0 (before scorer fix; ~8.0 after)

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

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