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 — 1433-word glossary with density 0.63

Đã đóng Phù hợp với người mới
#4,965 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
85/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, shell
Lĩnh vực
documentation

Hướng nghiên cứu

Bắt đầu bằng cách đọc workshop/side-quest-01-02-environment-reference.md và grep workshop/ để tìm các liên kết đến các anchor của nó. Chỉnh sửa tệp để thay thế văn xuôi bằng một bảng term|role|when-you-use-it, chuyển các ghi chú enterprise vào các khối <details> và thêm một tự kiểm tra gh --version. Hoàn thành khi tệp có ≤900 từ, các anchor được giữ nguyên và npx --yes markdownlint-cli2 qua được.

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 ≥ 9 (≤ 800 words) −2.7
active_learning 2.1 ≥ 10 (density ≥ 3) −7.9

(checkpoint_quality 0.0 / scaffolding 5.0 are rubric artifacts — see the separate rubric-regex issue.)

Root Cause (≤ 2 sentences):
At 1433 words (2× the corpus median of 706) and 17 concepts, this reference page has only 2 code blocks and 7 checklist items, so activity density is 0.63. It mixes a glossary, screenshots and enterprise notes in a single linear read.

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 and the Segmenting principle (Mayer) suggest long reference material should be chunked so learners look up only what they need. A glossary has legitimately low activity density, but splitting it lowers per-page load and makes anchor-links from lessons land on shorter pages.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md (a reference page, Bloom level "remember"). Reduce it to ≤ 900 words by (a) replacing prose descriptions with a compact term | role | when-you-use-it table, (b) moving the enterprise-hostname and OpenAI Codex/Claude model notes into short <details> blocks, and (c) keeping every existing heading anchor that other workshop pages link to (grep workshop/ for "side-quest-01-02-environment-reference.md#" first). Add a quick self-check (one code block with `gh --version`, `git --version`) near the top so density rises. Keep the ":white_check_mark: Checkpoint" section. Run `npx --yes markdownlint-cli2 "workshop/side-quest-01-02-environment-reference.md"`.

Expected Score After Fix: 6.0 / 10.0 (≈ 8.0 once the rubric regex fix lands)

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

  • expires on Oct 26, 2026, 3:44 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.