[curriculum-eval] 05-agentic-workflows-intro.md: cognitive_load — 1107-word core step with low activity density

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

Hướng nghiên cứu

Chỉnh sửa workshop/05-agentic-workflows-intro.md theo prompt cải thiện: rút gọn trang còn tối đa 800 từ, rút ngắn khối hướng dẫn bỏ qua nội dung, giữ các phần được nêu ngắn gọn, đồng thời giữ lại Activities 2 và 3 cùng checkpoint hiện có. Chạy npx --yes markdownlint-cli2 "**/*.md"; công việc hoàn tất khi trang đáp ứng giới hạn số từ và lệnh lint chạy thành công.

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/05-agentic-workflows-intro.md
Overall Score: 5.4 / 10.0 (corpus mean: 6.1)

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load reduced (1107 words) ≤ 800 words −3 pts approx.
active_learning low (flagged) density ≥ 3 below
checkpoint_quality 0.0 reported; a checkpoint exists at line 120 (regex false positive, see rubric issue) ≥ 4 items n/a

Root Cause (≤ 2 sentences):
A core-path page combines three terms, the two-file structure, and three activities, exceeding the word ceiling for a conceptual step. A skip-ahead block at the top also adds text before the first concept.

Evidence (quoted from the file):

"Before skipping, confirm you already know both of these: You can describe what an Actions workflow trigger does; You have worked with AI agent execution environments in a production or CI/CD context"

Learning Science Rationale:
Mayer's segmenting and Sweller's CLT predict that early conceptual steps benefit from shorter chunks. Core path step 05 is the learner's first exposure to agentic concepts, so extraneous load here has outsized effect on later steps.

Improvement Prompt (for an agent):

Edit workshop/05-agentic-workflows-intro.md to ≤ 800 words: shorten the skip-ahead block to a single sentence, keep "Three key terms" and "The two-file structure" concise, and keep Activity 2 and Activity 3 but tighten surrounding prose. Preserve the existing "## :white_check_mark: Checkpoint". Run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: 6.3 / 10.0

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

  • expires on Nov 7, 2026, 7:04 AM UTC
Ngôn ngữ chính
JavaScript
Star
58
Fork
40
Merge trung bình
4 ngày 4 giờ
Pull request đã merge (30 ngày)
8

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.