[curriculum-eval] 05-agentic-workflows-intro.md: active_learning — only one retrieval-practice moment after 1,107 words of prose

Đã đóng Phù hợp với người mới
  • Có gì không ổn?
#4,311 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
78/100
Loại issue
Tính năng
Độ 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

Đọc workshop/05-agentic-workflows-intro.md, đặc biệt là phần giới thiệu trigger, task brief và safe outputs, rồi tìm phần giải thích compile/.lock.yml. Thêm trước phần giải thích đó một mục checklist ngắn hoặc một bài tập đọc mã, đồng thời giữ nguyên bài tập kết thúc hiện có; công việc hoàn tất khi trang có điểm kiểm tra học tập chủ động sớm hơn như đã nêu.

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

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 8.5 ≤800 words, ≤15 concepts → 10 -1.5
active_learning 2.4 density ≥ 3 → 10 -7.6

Root Cause (≤ 2 sentences):
At 1,107 words (38% over the 800-word ideal) with only 2 code blocks, this conceptual introduction to agentic workflows relies heavily on explanatory prose to contrast agentic vs. classic Actions workflows, giving an activity density of 0.72 against the 3.0 target even though its concept count (15) is within the ideal range.

Evidence (quoted from the file):

The checkpoint's own "Still uncertain? Try this before moving on" collapsible exercise is the only interactive-recall moment on the page, appearing after all 1,107 words of narrative explanation.

Learning Science Rationale:
Mayer's active-processing principle (part of the Cognitive Theory of Multimedia Learning) argues that learners retain and transfer concepts better when practice opportunities are distributed throughout a lesson rather than concentrated at the end; placing the only retrieval-practice moment in a single collapsible aside after over a thousand words of exposition leaves most of the page's instructional time with no active engagement checkpoint.

Improvement Prompt (for an agent):

Edit workshop/05-agentic-workflows-intro.md to distribute active-learning opportunities earlier
in the page rather than only at the end. After the section introducing the three key terms
(trigger, task brief, safe outputs), add one short inline checklist item or code-reading
exercise asking the learner to identify these three elements in a short provided workflow
snippet, before continuing to the compile/`.lock.yml` explanation. Keep the existing "Still
uncertain?" exercise at the end but add this earlier checkpoint so code_blocks + checklist_items
density rises relative to the page's word count without needing to cut explanatory content.

Expected Score After Fix: 6.3-6.7 / 10.0

Generated by 🔬 Curriculum Quality Evaluator · copilot · auto · 96.9 AIC · ⌖ 19.9 AIC · ⊞ 10.4K · ◷

  • expires on Oct 8, 2026, 11:43 PM UTC
Ngôn ngữ chính
JavaScript
Star
56
Fork
40
Merge trung bình
2 ngày 14 giờ
Pull request đã merge (30 ngày)
13

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.