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

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

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

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

调研方向

从 workshop/04-github-actions-intro.md 开始,检查术语表、Quick Refresher、标记活动、跳过块、Before You Start 部分和检查点。将页面中的概念精简为 trigger、job、runner、action 和 step,其他术语则引导至 GitHub Actions 文档。当术语表有五行、必需部分均保留且检查点至少包含四项时,即为完成。

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

(Note: checkpoint_quality = 0 is a scorer false positive; the page has a 5-item checkpoint.)

Root Cause (≤ 2 sentences):
A page titled "in 5 Minutes" introduces triggers, jobs, runners, actions, steps and more terminology (28 concepts) in a short word count, so density of new terms is the issue, not length. Most of the content is explanation followed by a single labeling exercise.

Evidence (quoted from the file):

"You know workflows live in .github/workflows/" / "You can read on, jobs, and steps keys in a workflow file" / "You know each step runs on a GitHub-hosted runner"

Learning Science Rationale:
Cognitive Load Theory's pre-training principle (Mayer) says key terms should be introduced before the main explanation. Presenting 28 terms inline competes for working memory; a short glossary table followed by the labeling activity reduces extraneous load.

Improvement Prompt (for an agent):

Edit workshop/04-github-actions-intro.md. Reduce new concepts to ≤ 15 by limiting the page to trigger, job, runner, action and step (the five the labeling exercise uses), and defer others to a link to the GitHub Actions docs. Add a 5-row glossary table before the "Quick Refresher", keep the "Already know Actions?" skip block, the "Before You Start" section and a ≥ 4-item "## :white_check_mark: Checkpoint". Run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: 6.0 / 10.0 (with scorer fix: 8.9)

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

  • expires on Nov 13, 2026, 5:04 AM UTC
主要语言
JavaScript
星标
62
派生
43
平均合并
1 天 5 小时
30 天内合并 PR
9

环境准备

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