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

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

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

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

評価

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

調査の方向性

04-github-actions-intro.mdを読み、認識されるチェックポイントについて、リポジトリの評価基準の形式を確認してください。Step 5の前に、段階的な説明、注釈付きの最小限のワークフロー、予測してから答えを明かすアクティビティ、自己確認を追加してください。定量評価と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分
マージ済み PR(30日)
13

環境構築

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 を短くまとめたダイジェスト。