[curriculum-eval] 04-github-actions-intro.md: cognitive_load — 28 new concepts, the highest in the entire 93-file corpus
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 2/5
- 预计耗时
- 1-3 小时
- 新手友好度
- 62/100
- Issue 类型
- 文档
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 技术栈
- github-actions, markdown
- 领域
- content, documentation
调研方向
从 workshop/04-github-actions-intro.md 开始，找到 Quick Refresher、Classic Actions vs Agentic Workflow 对比表，以及“Label a sample workflow”练习。每个核心术语只在首次出现时加粗或设为代码格式；对 05-agentic-workflows-intro.md 后面才定义的前向引用（task brief、safe outputs）添加链接或取消加粗。保持检查点和练习的结构不变。重复强调消失且文件仍然通顺即完成。概念数量由评估器给出；请与维护者确认此次修改。
由索引模型根据 Issue 内容生成。
描述
File: workshop/04-github-actions-intro.md
Overall Score: 5.39 / 10.0 (as reported; ~8.14 / 10.0 after the checkpoint/scaffolding regex fix) — corpus mean: 6.09 / 10.0
Flagged Dimensions:
| Dimension | Score | Benchmark | Delta |
|---|---|---|---|
| concept_overload (new_concepts) | 28 concepts |
≤15 → full cognitive_load score | +13 over (highest in the entire 93-file corpus) |
| cognitive_load | 6.8 |
≤800 words, ≤15 concepts → 10 | -3.2 |
| active_learning | 3.9 |
≥3 → 10 | moderate, but concept density dominates |
Note: missing_checkpoint is a regex-bug artifact (file has a correctly formatted ## :white_check_mark: Checkpoint with 5 items). The genuine issue is that this page has the single highest new-concept count (28) of any file in the corpus, in only 756 words.
Root Cause (≤ 2 sentences):
The page bold/code-tags every Actions primitive (on, jobs, steps, runs-on, uses, run, trigger/job/runner/step/action) twice — once in the "Quick Refresher" table/YAML, again in the comparison table, and a third time in the "Label a sample workflow" exercise answer key — so the same ~10 core terms are re-counted as distinct bolded instances across three sections, inflating the concept count far beyond what a true refresher page should introduce. This is compounded by the side-by-side "Classic Actions vs Agentic Workflow" terminology table introducing additional paired terms (task brief, safe outputs) a lesson early, before step 05 formally defines them.
Evidence (quoted from the file):
"| Concept | Classic Actions | Agentic Workflow |\n|---|---|---|\n| Trigger (
on:) | Same — schedule, push, PR, dispatch | Same |\n| Runner (runs-on:) | GitHub-hosted or self-hosted | Same |\n| Steps | Shell commands you define | AI agent executes a plain-English task brief |\n| Output | Files, logs, deploy artifacts | GitHub comments, issues, PRs, or other API writes |"
Learning Science Rationale:
Sweller's Cognitive Load Theory notes that redundant re-presentation of the same concept in multiple bolded/coded forms (the "redundancy effect") increases extraneous load without adding germane value, since learners re-process already-known terms instead of consolidating them; this is especially costly in a page explicitly framed as a "5 minute refresher" for learners who may already know some of the material. Reducing duplicate bold/code emphasis to first-use-only, per Bloom's "Understand" level expectations for an intro refresher, would let the per-step concept count better reflect genuinely new material.
Improvement Prompt (for an agent):
Edit workshop/04-github-actions-intro.md to reduce redundant concept emphasis:
1. In the "Quick Refresher," "Why This Matters for Agentic Workflows" comparison table, and "Label a sample workflow" exercise, bold/code-format each core term (trigger, job, runner, step, action, on, jobs, steps, runs-on, uses, run) only on its first introduction in the page; use plain text for later repeated mentions of the same term.
2. In the "Why This Matters for Agentic Workflows" table, remove or de-emphasize forward-reference terms not yet taught (task brief, safe outputs) — either link them to where they are formally introduced in 05-agentic-workflows-intro.md or drop the bold/code styling since they are previews, not concepts this page teaches.
3. Keep all five existing checkpoint items and the exercise structure intact.
4. Re-measure new_concepts and confirm it drops from 28 toward 15-18, reflecting only the terms this specific refresher page is responsible for teaching.
Expected Score After Fix: 8.5 / 10.0
Generated by 🔬 Curriculum Quality Evaluator · copilot · auto · 107 AIC · ⌖ 14.9 AIC · ⊞ 10.4K · ◷
- expires on Oct 9, 2026, 11:43 PM UTC
- 主要语言
- JavaScript
- 星标
- 56
- 派生
- 40
- 平均合并
- 2 天 7 小时
- 30 天内合并 PR
- 16
环境准备
在浏览器里用你自己的 GitHub 账号启动这个项目的开发容器。
- 没有 Dockerfile 或 Docker Compose 文件
- 没有 Pull Request 模板
- 没有贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
githubnext/gh-aw-workshop 的其他 Issue
-
curriculum documentation quality
难度 2/5 1-3 小时 新手友好度 78/100
githubnext/gh-aw-workshop#5105 ·
维护者通常 1 天内回复
-
curriculum documentation quality
难度 2/5 1-3 小时 新手友好度 77/100
githubnext/gh-aw-workshop#5104 ·
维护者通常 1 天内回复
-
curriculum documentation quality
难度 2/5 1-3 小时 新手友好度 82/100
githubnext/gh-aw-workshop#5103 ·
维护者通常 1 天内回复
-
curriculum documentation quality
难度 2/5 1-3 小时 新手友好度 78/100
githubnext/gh-aw-workshop#5100 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 72/100
githubnext/gh-aw-workshop#3109 · 11 条评论 ·
维护者通常 1 天内回复
查看 githubnext/gh-aw-workshop 的全部 Issue
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 78/100
wazuh/wazuh-documentation#10584 ·
维护者通常 1 天内回复
-
documentation good first issue
难度 1/5 1 小时以内 新手友好度 94/100
-
难度 2/5 1-3 小时 新手友好度 78/100
InukaAsith/TwinDesk#84 ·
维护者通常 2 天内回复
-
难度 2/5 1-3 小时 新手友好度 76/100
Graphify-Labs/graphify#4860 · 1 条评论 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 65/100
CommandCodeAI/command-code#1088 ·
维护者通常 2 天内回复