Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

[workshop-sim] Repair: Add mid-page formative checkpoint to GitHub Actions intro (04-github-actions-intro.md)

オープン 初心者向け
#4,368 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
74/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
github-actions, markdown
領域
documentation

調査の方向性

変更は 04-github-actions-intro.md に加えます。場所は "Label a sample workflow" の展開ブロックの直後、"Try it: Explore a real workflow" の前です。周囲の展開式の回答パターンを読み、新しい2〜3問の復習クイズが同じ形式になるようにしてください。完了の条件は、クイズがインラインの展開機能付きで挿入されていること、既存の図、比較表、"Try it" の演習、最後のチェックリストが変更されていないこと、そして npx --yes markdownlint-cli2 "**/*.md" が新しいエラーを報告しないことです。

索引モデルが issue の本文から書いたものです。

説明

feedback simulation workshop

Problem statement

04-github-actions-intro.md is the lowest-scoring curriculum step overall (overall_score 5.39/10) and the #2 highest-failure step in the Monte Carlo simulation (7,231 failures across 1,000×46 runs, 16.4% conditional dropout among 44,183 at-risk runs). The failure category is 100% concept-overload: the page introduces 28 new concepts in one pass (word_count 756, 36 inline commands, 7 h2 sections) with no checkpoint or formative check between the "Label a sample workflow" activity and the following "Try it: Explore a real workflow" section. Learners — especially beginner/no-coding and github-basic personas — accumulate misunderstandings that compound into Step 5 (05-agentic-intro), the next-highest-dropout step.

Proposed change

Insert one short self-check immediately after the "Label a sample workflow" reveal-the-labels <details> block (before "Try it: Explore a real workflow"): a 2-3 item recall quiz ("Which key starts a workflow? Which key names the machine?") with an inline reveal, so learners catch labeling mistakes before moving to the live-repo activity. Do not remove or shorten the existing anatomy diagram, classic-vs-agentic comparison table, or the "Try it" browser activity — all of those are appropriately challenging content, not noise.

Failure mode classification: Learning barrier (conceptual density / insufficient mid-page scaffolding, not an access or tooling issue).

Quantitative guardrail

  • Current overall_score: 5.39/10
  • Weakest rubric dimensions: checkpoint_quality 0.0/10 (shared detection gap across all 30 steps — see report), active_learning 3.9/10
  • Current learning KPI index for this step: (2.0×3.9 + 2.0×0.0 + 1.5×5.0) / 5.5 = 2.78/10 (active_learning 3.9, checkpoint_quality 0.0, scaffolding 5.0)
  • The proposed change adds one more hands-on recall activity (raising active_learning) without touching readability, cognitive_load, or style_compliance, and should not lower scaffolding since it adds a support point rather than removing one. It should raise, not lower, overall_score and the learning KPI index.

Acceptance criteria

  • The shared curriculum quantitative assessment overall_score for 04-github-actions-intro.md stays flat or improves after the change
  • The step's learning KPI index (2.0×active_learning + 2.0×checkpoint_quality + 1.5×scaffolding)/5.5 stays flat or improves
  • The existing "Label a sample workflow" and "Try it" hands-on activities, the reveal-answer checkpoints, and the end-of-page ## :white_check_mark: Checkpoint checklist are preserved or strengthened, not removed or shortened
  • Markdown passes npx --yes markdownlint-cli2 "**/*.md" with no new errors

Suggested owner: workshop maintainer
Related to #4367

Generated by 🔬 Workshop Student Simulator · copilot · auto · 163.7 AIC · ⌖ 12.2 AIC · ⊞ 15.1K · ◷

  • expires on Oct 10, 2026, 7:10 AM UTC
主要言語
JavaScript
スター
52
フォーク
26
平均マージ
11時間 32分
マージ済み PR(30日)
22

環境構築

Codespaces で開く

このプロジェクトの開発コンテナを、あなたの GitHub アカウントでブラウザ上に起動します。

  • Dockerfile・Docker Compose ファイルなし
  • プルリクエストのテンプレートなし
  • コントリビューションガイドなし

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

githubnext/gh-aw-workshop のほかの issue

githubnext/gh-aw-workshop の issue をすべて見る

似ている issue

JavaScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。