[curriculum-eval] side-quest-01-02-environment-reference.md: cognitive_load — 1,433-word reference page with low activity density

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

Hướng nghiên cứu

Bắt đầu với workshop/side-quest-01-02-environment-reference.md, đặc biệt là các phần thuật ngữ và ảnh chụp màn hình khái niệm, đồng thời kiểm tra workshop/README.md nếu nội dung được chia sang tệp khác. Thêm các lệnh thực hành ngắn trong terminal cùng đầu ra dự kiến, đồng thời giữ mỗi phần trong giới hạn số từ đã nêu và bảo toàn ít nhất bốn mục checkpoint có thể xác minh. Chạy npx --yes markdownlint-cli2 "**/*.md"; điểm mục tiêu của bộ đánh giá là 6.5.

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

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 6.3 ≤ 800 words +633 words over budget
active_learning 2.1 density ≥ 3 density 0.63 (−2.37)

Root Cause (≤ 2 sentences):
The page packs a glossary (lines 15–53) and a long "Conceptual screenshots" section (lines 54–154) into one file, giving 1,433 words with only 2 code blocks. It reads as reference material but has no practice tasks.

Evidence (quoted from the file):

Environment and tool glossary ... ## Conceptual screenshots

Learning Science Rationale:
Mayer's segmenting principle says complex material is learned better in learner-paced segments, and Sweller's CLT warns that long undifferentiated text raises extraneous load. Retrieval practice (Roediger & Karpicke) also shows that adding brief self-check tasks to reference content improves retention.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md. Split it into two files (glossary; conceptual screenshots) each ≤ 800 words, or collapse the screenshots section into <details> blocks. Add 2–3 short "try it" terminal commands with expected output so activity density ≥ 3 per 100 words. Keep the existing "## :white_check_mark: Checkpoint" with ≥ 4 verifiable items, update workshop/README.md if you add a file, run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: 6.5 / 10.0

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

  • expires on Oct 31, 2026, 4:04 AM UTC
Ngôn ngữ chính
JavaScript
Star
56
Fork
40
Merge trung bình
2 ngày 15 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.