Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

[curriculum-eval] side-quest-01-02-environment-reference.md: active_learning — low activity density in a long glossary/reference page

Đã đóng Phù hợp với người mới
  • Có gì không ổn?
#3,673 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
84/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

Chỉnh sửa workshop/side-quest-01-02-environment-reference.md, bắt đầu với bảng “Environment and tool glossary” và phần “Verify your tools are ready” hiện có. Thêm các hoạt động tự kiểm tra được yêu cầu sau mỗi cụm chủ đề, đưa bước kiểm tra gh --version / git --version lên sớm hơn và giữ nguyên checkpoint. Chạy npx --yes markdownlint-cli2 "**/*.md"; khi hoàn tất, trang sẽ có nhiều hoạt động đan xen hơn và vượt qua bước kiểm tra lint 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
active_learning 2.1 ≥ activity density 3 (score 10) -7.9
cognitive_load 6.3 ≤ 800 words / ≤ 15 concepts (score 10) -3.7

Note: the rubric also flags missing_checkpoint/checkpoint_quality: 0.0, but this is a confirmed tooling bug — the file contains a well-formed ## :white_check_mark: Checkpoint section with 7 specific checklist items. The rubric's CHECKPOINT_RE only matches a literal ✅ character, not the :white_check_mark: shortcode used throughout this workshop. That flag should be dismissed for scoring purposes (see the scorecard issue for the tooling fix).

Root Cause (≤ 2 sentences):
At 1,433 words with 17 new concepts and only 2 code blocks / 9 checklist items, this reference page has very low activity density (0.63 vs. the ≥3 ideal) because it is a long prose-and-table glossary with almost no hands-on interaction until the very end. The nine-item tool/environment table and eight paired screenshot sections are read-only content stretched across most of the page.

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.

| Term | What it means in this workshop | When you use it | Official documentation |

Learning Science Rationale:
Mayer's multimedia principle on generative activity (and the broader active-learning literature) shows that passive reading of reference tables and paired screenshots — without an interleaved retrieval or verification step — produces shallow, non-durable encoding. A 1,400-word glossary read start-to-finish, with the only "do this" action (gh --version / git --version) buried near the end, gives learners little opportunity to actively process the terms as they're introduced, increasing the risk that the glossary is skimmed rather than internalized.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md to raise activity density. After each thematic cluster in the "Environment and tool glossary" table (development environments; workshop tools and model options), insert a short self-check activity such as a 2-3 item micro-quiz or "match the tool to its use" prompt (e.g., "Which tool would you use to compile a workflow file? Which tool would you use to view a compiled .lock.yml?") with an answer in a collapsible <details> block. Also move the "Verify your tools are ready" gh --version / git --version check earlier, right after the glossary table, instead of leaving it as the only interactive element near the end. Keep the existing checkpoint section unchanged. Run npx --yes markdownlint-cli2 "**/*.md" after editing.

Expected Score After Fix: 6.0 / 10.0

Generated by 🔬 Curriculum Quality Evaluator · copilot · auto · 74.5 AIC · ⌖ 11.9 AIC · ⊞ 9K · ◷

  • expires on Sep 23, 2026, 3:48 AM UTC
Ngôn ngữ chính
JavaScript
Star
55
Fork
36
Merge trung bình
2 ngày 8 giờ
Pull request đã merge (30 ngày)
17

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.