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

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

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

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

評価

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

調査の方向性

workshop/04-github-actions-intro.mdから始め、Quick Refresherとラベリング活動で使われている5つの用語を比較します。CheckpointとBefore You Startのセクション、二人称の語調、番号なしの見出しを維持し、概念を減らして実践項目を追加した後、issueに記載されたmarkdownlintコマンドを実行します。リフレッシャーが指定された概念数の上限を満たし、lintコマンドが成功すれば完了です。

索引モデルが 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 ≥ 8 (≤ 15 concepts, ≤ 800 words) −1.2 (28 concepts vs 15)
active_learning 3.9 ≥ 10 (density ≥ 3) −6.1

(checkpoint/scaffolding penalties are a rubric artifact, see the rubric-regex issue; the page does have both sections.)

Root Cause (≤ 2 sentences):
The page introduces ~28 new terms (trigger, job, runner, action, step, workflow file, etc.) in 756 words, which exceeds the 15-concept guideline. Activity density is low (5 checklist items, few code blocks) relative to the prose.

Evidence (quoted from the file):

You'll do a fast refresher on the Actions primitives used in this workshop: triggers, jobs, steps, and workflow files.

Learning Science Rationale:
Sweller's Cognitive Load Theory holds that working memory handles only a handful of novel elements at once; presenting 28 terms in one sitting raises intrinsic load beyond novices' capacity. Chunking terms around the five already-labelled parts (trigger, job, runner, action, step) and deferring the rest follows the segmenting principle in Mayer's multimedia learning.

Improvement Prompt (for an agent):

Edit workshop/04-github-actions-intro.md. Reduce new concepts to ≤ 15 by limiting the "Quick Refresher" to the five terms used in the labelling activity (trigger, job, runner, action, step) and moving any extra terminology to a collapsed <details> or a link to the Actions side quest. Add one more hands-on item (a short code block the learner edits or a labelling prompt). Keep the existing "## :white_check_mark: Checkpoint" and "## :clipboard: Before You Start" sections, second-person tone, and no numbered headings. Run `npx --yes markdownlint-cli2 "workshop/04-github-actions-intro.md"`.

Expected Score After Fix: 7.0 / 10.0 (≈ 8.5 once the rubric regex is fixed)

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

  • expires on Nov 11, 2026, 3:04 AM UTC
主要言語
JavaScript
スター
58
フォーク
40
平均マージ
1日 22時間
マージ済み PR(30日)
7

環境構築

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