[curriculum-eval] side-quest-01-02-environment-reference.md: cognitive_load — 1,536 words with low activity density

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

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

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

評価

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

調査の方向性

workshop/side-quest-01-02-environment-reference.md を開き、用語集の表、チェックポイントのセクション、83–195 行目の「Conceptual screenshots」ブロックに注意しながら、最初から最後まで読んでください。そのスクリーンショットのセクションを新しい side-quest-01-04-environment-screenshots.md に移動し、メインページからリンクし、gh --version、git --version、gh auth status を実行する短い「Try it」ブロックを追加してから、新しいファイルを workshop/README.md に追加してください。完了条件は、メインページが約 800 語未満で、既存の見出しが変更されておらず番号も付いておらず、npx --yes markdownlint-cli2 "**/*.md" が通ることです。

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

説明

curriculum documentation quality

File: workshop/side-quest-01-02-environment-reference.md
Overall Score: 4.8 / 10.0 (corpus mean: 6.1)

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 5.3 ≥ 9 (≤ 800 words, ≤ 15 concepts) −3.7 (1,536 words, 19 concepts)
active_learning 2.4 ≥ 10 (density ≥ 3) −7.6 (density 0.72)

(Note: checkpoint_quality 0.0 and scaffolding 5.0 are scorer false positives; the page has both :white_check_mark: Checkpoint and :clipboard: Before You Start sections. See the scorer-regex issue.)

Root Cause (≤ 2 sentences):
A glossary table plus a long "Conceptual screenshots" section (lines 83–195) roughly doubles the page beyond the 800-word ideal. The reference content has only 4 code blocks, so the learner mostly reads instead of acting.

Evidence (quoted from the file):

Knowing which name maps to which role helps you follow workshop instructions without stopping to wonder what "the terminal" or "Codespaces" means in context.

Learning Science Rationale:
Sweller's Cognitive Load Theory predicts that long reference material introduced all at once overwhelms working memory and leaves little capacity for schema formation; the segmenting principle (Mayer) recommends splitting content into learner-paced chunks. Pairing each term with a quick verify command (retrieval practice) turns passive reading into active learning.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md. Split the page so the main file stays under ~800 words: keep the glossary table and checkpoint, and move the "Conceptual screenshots" section (lines 83–195) into a new side-quest file (e.g. side-quest-01-04-environment-screenshots.md) linked from the main page. Add a short "Try it" code block after the glossary that runs `gh --version`, `git --version`, and `gh auth status`. Keep the existing `## :white_check_mark: Checkpoint` and `## :clipboard: Before You Start` headings, do not number headings, update workshop/README.md if a file is added, and run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: 6.5 / 10.0 (before scorer fix); 8.0+ after the scorer fix

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

  • expires on Nov 23, 2026, 4:03 AM UTC
主要言語
JavaScript
スター
61
フォーク
43
平均マージ
10時間 38分
マージ済み PR(30日)
12

環境構築

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