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

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

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

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

调研方向

从 workshop/04-github-actions-intro.md 开始,检查 Quick Refresher、示例 workflow 活动和 checkpoint。将引入的概念与 issue 的 15 个概念目标进行比较,并查阅 workshop/side-quest-05-01-actions-power-user.md,了解提议移出的细节。完成标准是:复习部分仅限于 on/jobs/steps,活动紧随其后,checkpoint 至少包含四个可验证的项目。

由索引模型根据 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 (756 words, 28 concepts) ≤ 15 concepts -3.2
active_learning 3.9 density ≥ 3 → 10 -6.1

Root Cause (≤ 2 sentences):
The step introduces trigger, job, runner, action, step, on, jobs, steps, etc. plus a bridge to agentic workflows — nearly double the concept budget. This is a core-path lesson where learners are least equipped to chunk the vocabulary.

Evidence (quoted from the file):

A GitHub Actions workflow is a YAML file in .github/workflows/ that tells GitHub: when to run (on), what to run (jobs), how each job executes (steps)

Learning Science Rationale:
Miller/Sweller limits on working memory predict that introducing ~28 elements in one step overloads novices; Mayer's segmenting principle suggests presenting vocabulary in smaller chunks tied to an immediate activity, so each term is anchored by use before the next arrives.

Improvement Prompt (for an agent):

Edit workshop/04-github-actions-intro.md: reduce new concepts to ≤ 15 by limiting the "Quick Refresher" to on/jobs/steps and moving runner/action/matrix-style detail to a link or side quest (workshop/side-quest-05-01-actions-power-user.md). Place the "Label a sample workflow" activity directly after the refresher. Keep the ":white_check_mark: Checkpoint" with ≥ 4 verifiable items, keep headings unnumbered, and run npx --yes markdownlint-cli2 "**/*.md".

Expected Score After Fix: 6.5 / 10.0 (before scorer fix)

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

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