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

已关闭 适合新手
  • 哪里不对？
#5,320 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 3 天内回复

还没有人认领这个 Issue。

评估

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

调研方向

从 workshop/04-github-actions-intro.md 开始，将 Quick Refresher、标签练习和 workflow 探索与 issue 的五个关键术语进行对照。简化词汇并添加一项动手练习，同时保留名为 Checkpoint 和 Before You Start 的部分。完成标准是页面按描述减少概念并增加活动；运行 npx --yes markdownlint-cli2 "**/*.md"。

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

描述

curriculum documentation quality

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

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 6.8 (756 words, 28 concepts) ≤ 15 concepts → 10 −3.2
active_learning 3.9 (density 1.19) density ≥ 3 −6.1

(checkpoint_quality 0.0 / scaffolding 5.0 are rubric false negatives — the page has ## :white_check_mark: Checkpoint with 5 items and ## :clipboard: Before You Start.)

Root Cause (≤ 2 sentences):
The page is titled "GitHub Actions in 5 Minutes" but introduces 28 distinct terms (trigger, job, runner, action, step, on, jobs, steps, etc.) across 7 sections. Confirmed: the Quick Refresher plus labeling exercise plus a real-workflow exploration is more than five minutes of new vocabulary.

Evidence (quoted from the file):

Already know GitHub Actions? Confirm these three statements and skip ahead: You know workflows live in .github/workflows/ as YAML files / You can read on, jobs, and steps keys in a workflow file

Learning Science Rationale:
Miller/Cowan working-memory limits and Sweller's Cognitive Load Theory predict that more than ~4–7 novel elements at once overwhelms novices. Pre-training (Mayer) — introducing the five key terms first, then examples — reduces intrinsic load, and worked examples with faded guidance help novices connect the terms.

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 parts used in the labeling exercise (trigger, job, runner, action, step), moving optional terms (e.g. `on`/`jobs`/`steps` syntax detail, extra definitions) to a <details> block or an existing side-quest, and replacing long prose with a one-line definition table. Add one more hands-on item (e.g. a code block the learner edits) so activity density rises toward 3. Keep the `:white_check_mark: Checkpoint` (≥ 4 specific items) and `:clipboard: Before You Start`. Run `npx --yes markdownlint-cli2 "**/*.md"`.

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

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

  • expires on Nov 5, 2026, 4:05 AM UTC
主要语言
JavaScript
星标
58
派生
40
平均合并
4 天 4 小时
30 天内合并 PR
8

环境准备

在 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 摘要。