[curriculum-eval] 04-github-actions-intro.md: cognitive_load — 28 new concepts in a "5 minutes" refresher

未关闭 适合新手
#5,544 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
2/5
预计耗时
1-3 小时
新手友好度
75/100
Issue 类型
文档
描述清晰度
描述清楚
活跃度
活跃
技术栈
github-actions, markdown
领域
documentation

调研方向

从 workshop/04-github-actions-intro.md 开始,将 Quick Refresher 与标签活动中使用的五个术语进行比较。保留 Checkpoint 和 Before You Start 两个部分、第二人称语气以及不编号的标题;减少概念,添加一个动手实践项目,然后运行 issue 中给出的 markdownlint 命令。完成标准是 refresher 符合规定的概念数量上限,且 lint 命令通过。

由索引模型根据 Issue 内容生成。

描述

curriculum documentation quality

File: workshop/04-github-actions-intro.md
Overall Score: 5.4 / 10.0 (corpus mean: 6.1)

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 6.8 ≥ 8 (≤ 15 concepts, ≤ 800 words) −1.2 (28 concepts vs 15)
active_learning 3.9 ≥ 10 (density ≥ 3) −6.1

(checkpoint/scaffolding penalties are a rubric artifact, see the rubric-regex issue; the page does have both sections.)

Root Cause (≤ 2 sentences):
The page introduces ~28 new terms (trigger, job, runner, action, step, workflow file, etc.) in 756 words, which exceeds the 15-concept guideline. Activity density is low (5 checklist items, few code blocks) relative to the prose.

Evidence (quoted from the file):

You'll do a fast refresher on the Actions primitives used in this workshop: triggers, jobs, steps, and workflow files.

Learning Science Rationale:
Sweller's Cognitive Load Theory holds that working memory handles only a handful of novel elements at once; presenting 28 terms in one sitting raises intrinsic load beyond novices' capacity. Chunking terms around the five already-labelled parts (trigger, job, runner, action, step) and deferring the rest follows the segmenting principle in Mayer's multimedia learning.

Improvement Prompt (for an agent):

Edit workshop/04-github-actions-intro.md. Reduce new concepts to ≤ 15 by limiting the "Quick Refresher" to the five terms used in the labelling activity (trigger, job, runner, action, step) and moving any extra terminology to a collapsed <details> or a link to the Actions side quest. Add one more hands-on item (a short code block the learner edits or a labelling prompt). Keep the existing "## :white_check_mark: Checkpoint" and "## :clipboard: Before You Start" sections, second-person tone, and no numbered headings. Run `npx --yes markdownlint-cli2 "workshop/04-github-actions-intro.md"`.

Expected Score After Fix: 7.0 / 10.0 (≈ 8.5 once the rubric regex is fixed)

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

  • expires on Nov 11, 2026, 3:04 AM UTC
主要语言
JavaScript
星标
58
派生
40
平均合并
1 天 22 小时
30 天内合并 PR
7

环境准备

在 Codespaces 中打开

在浏览器里用你自己的 GitHub 账号启动这个项目的开发容器。

  • 没有 Dockerfile 或 Docker Compose 文件
  • 没有 Pull Request 模板
  • 没有贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

githubnext/gh-aw-workshop 的其他 Issue

查看 githubnext/gh-aw-workshop 的全部 Issue

相似的 Issue

更多 JavaScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。