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

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

维护者通常 3 天内回复

还没有人认领这个 Issue。

评估

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

调研方向

阅读workshop/04-github-actions-intro.md,并将其中的概念和活动与规定的限制进行比较:新增概念最多15个,活动密度至少为3。保留五个标记相关概念,将额外术语连同链接移至workshop/side-quest-05-01-actions-power-user.md,保留“Before You Start”和Checkpoint,并添加一个实践代码块或一个清单步骤。运行npx --yes markdownlint-cli2 "**/*.md";内容符合这些限制且lint通过即表示完成。

由索引模型根据 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 10 (≤ 15 concepts) −3.2
active_learning 3.9 10 (density ≥ 3) −6.1
checkpoint_quality / scaffolding 0.0 / 5.0 rubric false negatives see regex issue

Root Cause (≤ 2 sentences):
At 756 words the page introduces 28 new concepts (13 over the limit of 15) across a refresher, a labeling activity and a real-workflow exploration. Activity density is 1.19, well below 3.

Evidence (quoted from the file):

- [ ] You can describe one way agentic workflows extend classic Actions (same trigger and runner; AI agent replaces fixed shell steps)

Learning Science Rationale:
Sweller's Cognitive Load Theory holds that intrinsic load rises with element interactivity; 28 terms exceed the roughly 4±1 chunks novices can hold. Mayer's pre-training principle suggests introducing key terms (trigger, job, runner, action, step) first and deferring the rest.

Improvement Prompt (for an agent):

Edit workshop/04-github-actions-intro.md. Reduce new concepts to ≤ 15 by focusing only on the five parts the learner must label (trigger, job, runner, action, step) and moving extra terms (matrix, secrets, contexts, etc.) to workshop/side-quest-05-01-actions-power-user.md via a link. Keep "Before You Start" and the Checkpoint (:white_check_mark: shortcode form). Add one more hands-on code block or checklist step to raise activity density. Run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: 7.8 / 10.0 (≈ 6.5 from content fixes alone)

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

  • expires on Nov 9, 2026, 5: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 摘要。