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

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

クローズ 初心者向け
#4,705 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

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

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

評価

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

調査の方向性

workshop/04-github-actions-intro.md を編集し、まず Quick Refresher とその単一の実例ワークフローを扱います。導入する概念を on、jobs、steps、runner に絞り、余分な用語は <details> に移し、スキップ用ボックス、Before You Start、Checkpoint は保持してください。markdownlint を実行します。指定された概念数の上限を満たし、内容が一貫していれば完成です。

索引モデルが 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 ≥ 8 -3 concepts-equivalent / 13 over limit
active_learning 3.9 ≥ 7 -3.1

Root Cause (≤ 2 sentences):
The 'in 5 minutes' refresher introduces 28 concepts (triggers, jobs, runners, steps, actions, YAML, etc.) in 756 words. Learners who already know Actions must still wade through the Quick Refresher.

Evidence (quoted from the file):

A GitHub Actions workflow is a YAML file in .github/workflows/ that tells GitHub: when to run (on), what to run (jobs), how each job executes (steps)

Learning Science Rationale:
Sweller's Cognitive Load Theory predicts that learners can hold only a few new elements in working memory; exceeding the concept and length budget raises extraneous load and reduces schema formation. Splitting content into focused, chunked pieces with practice between them restores germane load. Worked-example effects favour a single annotated workflow over several definitions.

Improvement Prompt (for an agent):

Edit workshop/04-github-actions-intro.md: reduce new concepts to ≤ 15 by teaching only on/jobs/steps/runner using the single sample workflow; move extra terminology to a <details> block. Retain the skip-ahead box, Before You Start and Checkpoint. Run markdownlint.

Expected Score After Fix: 6.3 / 10.0

Generated by 🔬 Curriculum Quality Evaluator · copilot · auto · 29.6 AIC · ⌖ 0.746 AIC · ⊞ 10.4K · ◷

  • expires on Oct 19, 2026, 3:41 AM 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 を短くまとめたダイジェスト。