[workshop-sim] Improve: Add worked example and self-check to GitHub Actions intro (Step 4)

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

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

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

调研方向

阅读 04-github-actions-intro.md,并检查 repository 的评分标准格式,了解如何设置一个认可的检查点。在 Step 5 之前添加分层说明、带注释的最简 workflow、先预测再揭晓的活动,以及自我检查。运行定量评估和 Markdown lint;当两项评分持平或提高,且动手练习、检查点和脚手架支持得到保留或加强时,即视为完成。

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

描述

feedback simulation workshop
Problem statement

04-github-actions-intro.md loses 16.4% of 44,172 at-risk runs to concept-overload (7,224 failures). It is tied for lowest overall score in the corpus. Beginner learners (0.5% mean success) and github-basic learners (14.4%) are hit hardest. The page introduces about 28 new concepts in 766 words and has no checkpoint detected by the rubric.

Proposed change
  • Introduce the concepts in layers: trigger, then job, then step, then runner. Do not present them as one block.
  • Add one worked example of a minimal workflow with annotations, followed by a predict-then-reveal activity.
  • Add a short self-check before moving to Step 5.
  • Confirm the ## :white_check_mark: Checkpoint section follows the format the rubric recognises.
Failure mode classification

Learning barrier. Address it with scaffolding and checkpoints, not by removing concepts.

Quantitative guardrail
  • 04-github-actions-intro.md: overall_score 5.39; active_learning 3.9, checkpoint_quality 0.0, scaffolding 5.0; learning KPI index 2.78. Weakest dimensions: checkpoint_quality, then active_learning.
  • Adding a worked example, a predict-and-reveal activity and a self-check targets all three KPI dimensions, so the scores should rise. Concepts are kept, not removed.
Acceptance criteria
  • The shared curriculum quantitative assessment overall_score for 04-github-actions-intro.md stays flat or improves.
  • The learning KPI index ((2.0 × active_learning + 2.0 × checkpoint_quality + 1.5 × scaffolding) / 5.5) stays flat or improves from 2.78.
  • Hands-on practice, checkpoints, and scaffolding are preserved or strengthened, not removed.
  • Markdown lint passes.
Suggested owner

workshop maintainer

Generated by 🔬 Workshop Student Simulator · copilot · auto · ~40 AIC · ⌖ ~1 AIC · ⊞ 15.4K · ◷

  • expires on Nov 20, 2026, 9:04 AM UTC
主要语言
JavaScript
星标
61
派生
43
平均合并
11 小时 26 分钟
30 天内合并 PR
13

环境准备

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