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

[curriculum-eval] 04-github-actions-intro.md: cognitive_load — 28 new concepts, the highest in the entire 93-file corpus

クローズ 初心者向け
  • 何か問題がありますか？
#4,353 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

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

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

評価

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

調査の方向性

workshop/04-github-actions-intro.md から始めて、Quick Refresher、Classic Actions vs Agentic Workflow の比較表、「Label a sample workflow」の演習を見つけてください。主要な用語は初出の箇所だけを太字にするかコード書式にしてください。05-agentic-workflows-intro.md で後から定義される先行参照（task brief、safe outputs）は、リンクにするか太字を外してください。チェックポイントと演習の構造は変更しないでください。重複した強調が消え、ファイルが読みやすいままであれば完了です。概念数はエバリュエーターが算出します。編集内容はメンテナーに確認してください。

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

説明

curriculum documentation quality

File: workshop/04-github-actions-intro.md
Overall Score: 5.39 / 10.0 (as reported; ~8.14 / 10.0 after the checkpoint/scaffolding regex fix) — corpus mean: 6.09 / 10.0

Flagged Dimensions:

Dimension Score Benchmark Delta
concept_overload (new_concepts) 28 concepts ≤15 → full cognitive_load score +13 over (highest in the entire 93-file corpus)
cognitive_load 6.8 ≤800 words, ≤15 concepts → 10 -3.2
active_learning 3.9 ≥3 → 10 moderate, but concept density dominates

Note: missing_checkpoint is a regex-bug artifact (file has a correctly formatted ## :white_check_mark: Checkpoint with 5 items). The genuine issue is that this page has the single highest new-concept count (28) of any file in the corpus, in only 756 words.

Root Cause (≤ 2 sentences):
The page bold/code-tags every Actions primitive (on, jobs, steps, runs-on, uses, run, trigger/job/runner/step/action) twice — once in the "Quick Refresher" table/YAML, again in the comparison table, and a third time in the "Label a sample workflow" exercise answer key — so the same ~10 core terms are re-counted as distinct bolded instances across three sections, inflating the concept count far beyond what a true refresher page should introduce. This is compounded by the side-by-side "Classic Actions vs Agentic Workflow" terminology table introducing additional paired terms (task brief, safe outputs) a lesson early, before step 05 formally defines them.

Evidence (quoted from the file):

"| Concept | Classic Actions | Agentic Workflow |\n|---|---|---|\n| Trigger (on:) | Same — schedule, push, PR, dispatch | Same |\n| Runner (runs-on:) | GitHub-hosted or self-hosted | Same |\n| Steps | Shell commands you define | AI agent executes a plain-English task brief |\n| Output | Files, logs, deploy artifacts | GitHub comments, issues, PRs, or other API writes |"

Learning Science Rationale:
Sweller's Cognitive Load Theory notes that redundant re-presentation of the same concept in multiple bolded/coded forms (the "redundancy effect") increases extraneous load without adding germane value, since learners re-process already-known terms instead of consolidating them; this is especially costly in a page explicitly framed as a "5 minute refresher" for learners who may already know some of the material. Reducing duplicate bold/code emphasis to first-use-only, per Bloom's "Understand" level expectations for an intro refresher, would let the per-step concept count better reflect genuinely new material.

Improvement Prompt (for an agent):

Edit workshop/04-github-actions-intro.md to reduce redundant concept emphasis:
1. In the "Quick Refresher," "Why This Matters for Agentic Workflows" comparison table, and "Label a sample workflow" exercise, bold/code-format each core term (trigger, job, runner, step, action, on, jobs, steps, runs-on, uses, run) only on its first introduction in the page; use plain text for later repeated mentions of the same term.
2. In the "Why This Matters for Agentic Workflows" table, remove or de-emphasize forward-reference terms not yet taught (task brief, safe outputs) — either link them to where they are formally introduced in 05-agentic-workflows-intro.md or drop the bold/code styling since they are previews, not concepts this page teaches.
3. Keep all five existing checkpoint items and the exercise structure intact.
4. Re-measure new_concepts and confirm it drops from 28 toward 15-18, reflecting only the terms this specific refresher page is responsible for teaching.

Expected Score After Fix: 8.5 / 10.0

Generated by 🔬 Curriculum Quality Evaluator · copilot · auto · 107 AIC · ⌖ 14.9 AIC · ⊞ 10.4K · ◷

  • expires on Oct 9, 2026, 11:43 PM UTC
主要言語
JavaScript
スター
53
フォーク
35
平均マージ
1日 6時間
マージ済み PR（30日）
15

環境構築

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