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

[curriculum-eval] 04-github-actions-intro.md: cognitive_load — redundant YAML example doubles concept count in labeling exercise

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

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

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

評価

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

調査の方向性

workshop/04-github-actions-intro.mdを読み、「Label a sample workflow」と「Why This Matters for Agentic Workflows」の各セクションに注目し、その後、上の注釈付きの例と比較してください。演習から重複しているYAMLを削除し、指定どおり比較表を短くして、指定されたセクションは変更せずに残してください。markdownlint-cli2を実行してください。演習では引き続き学習者に5行のラベル付けを求め、表にはTriggerとStepsだけを残してください。

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

説明

curriculum documentation quality

File: workshop/04-github-actions-intro.md
Overall Score: 5.39 / 10.0 (corpus mean: 6.09)

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 6.8 ≤ 15 new concepts −6.5 concept penalty (28 new concepts, nearly double budget, in only 756 words)
active_learning 3.9 density ≥ 3 −6.1 (density 1.19)

Root Cause (≤ 2 sentences):
This is the corpus's highest new-concept-per-word page outside the anthropic-key side quest — 28 bolded/code terms in 756 words — because it simultaneously introduces Actions vocabulary (trigger, job, runner, step, action), a full annotated YAML example, a second "label the five parts" exercise with its own five-line YAML, and an Actions-vs-agentic comparison table, each contributing new terms in quick succession. The "Label a sample workflow" exercise repeats four of the five terms already defined in the "Quick Refresher" section and annotated example just above it, adding redundant vocabulary load rather than new content.

Evidence (quoted from the file):

"on: [push] / jobs: test: ... Write a label beside each line: 1. on: [push] 2. test: (the job name under jobs:) 3. runs-on: ubuntu-latest 4. uses: actions/checkout@v4 5. run: echo \"All checks passed\"" (a second full YAML example restating trigger/job/runner/step/action after they were already defined and shown in the first annotated example)

Learning Science Rationale:
Cognitive Load Theory's redundancy effect states that presenting the same information in two different forms (an annotated code block, then a nearly identical un-annotated code block for labeling) increases extraneous load without adding germane learning value, because learners must reprocess information they already encoded. Removing the duplicate "Hello Workflow" YAML in the labeling exercise and instead asking learners to label the already-annotated example consolidates this page's concept count under budget while preserving the retrieval-practice benefit of the labeling activity.

Improvement Prompt (for an agent):

Edit workshop/04-github-actions-intro.md to reduce concept load:
1. In the "## Label a sample workflow" section, remove the second
   "```yaml .github/workflows/hello-workflow.yml``` on: [push] / jobs: test: ..."
   code block, since it duplicates the "Annotated example" code block above it almost
   term-for-term. Instead have the exercise instruction say "Using the annotated example
   above, write a label beside each of these five lines" and reference the five lines by
   quoting them inline rather than repeating the full YAML block.
2. Shorten the "Why This Matters for Agentic Workflows" comparison table to the 2 rows
   most relevant to this page (Trigger, Steps) and move the remaining rows (Runner,
   Output) to 05-agentic-workflows-intro.md where they are covered in more depth, to
   avoid introducing extra comparison vocabulary twice in one page.
Keep the "what is a runner?" <details> block, the "Try it" exercise, and the Checkpoint
section unchanged. Re-run markdownlint-cli2 after editing.

Expected Score After Fix: 6.3–6.7 / 10.0

Generated by 🔬 Curriculum Quality Evaluator · copilot · auto · 119.1 AIC · ⌖ 17.8 AIC · ⊞ 10.4K · ◷

  • expires on Oct 13, 2026, 4:04 AM UTC
主要言語
JavaScript
スター
52
フォーク
26
平均マージ
12時間 58分
マージ済み 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 を短くまとめたダイジェスト。