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

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

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

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

評価

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

調査の方向性

workshop/04-github-actions-intro.mdから始め、用語集、Quick Refresher、ラベル付けアクティビティ、スキップブロック、Before You Start セクション、チェックポイントを確認してください。ページ内の概念を trigger、job、runner、action、step に絞り、その他の用語は GitHub Actions のドキュメントを参照するようにしてください。用語集が5行で、必須セクションが維持され、チェックポイントに少なくとも4項目がある状態で完了です。

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

(Note: checkpoint_quality = 0 is a scorer false positive; the page has a 5-item checkpoint.)

Root Cause (≤ 2 sentences):
A page titled "in 5 Minutes" introduces triggers, jobs, runners, actions, steps and more terminology (28 concepts) in a short word count, so density of new terms is the issue, not length. Most of the content is explanation followed by a single labeling exercise.

Evidence (quoted from the file):

"You know workflows live in .github/workflows/" / "You can read on, jobs, and steps keys in a workflow file" / "You know each step runs on a GitHub-hosted runner"

Learning Science Rationale:
Cognitive Load Theory's pre-training principle (Mayer) says key terms should be introduced before the main explanation. Presenting 28 terms inline competes for working memory; a short glossary table followed by the labeling activity reduces extraneous load.

Improvement Prompt (for an agent):

Edit workshop/04-github-actions-intro.md. Reduce new concepts to ≤ 15 by limiting the page to trigger, job, runner, action and step (the five the labeling exercise uses), and defer others to a link to the GitHub Actions docs. Add a 5-row glossary table before the "Quick Refresher", keep the "Already know Actions?" skip block, the "Before You Start" section and a ≥ 4-item "## :white_check_mark: Checkpoint". Run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: 6.0 / 10.0 (with scorer fix: 8.9)

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

  • expires on Nov 13, 2026, 5:04 AM UTC
主要言語
JavaScript
スター
62
フォーク
43
平均マージ
1日 5時間
マージ済み PR(30日)
9

環境構築

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