[curriculum-eval] side-quest-01-02-environment-reference.md: cognitive_load / active_learning — 1,433-word glossary with no hands-on activity

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

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

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

評価

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

調査の方向性

workshop/side-quest-01-02-environment-reference.mdから始め、用語集の長さと実践的な内容を、issueの制限や例と比較してください。Before You StartとCheckpointのセクションを残し、事実と二人称の語調を保ったうえで、短い練習を1つ追加してください。ページが900語以内で、指定されたコールアウトと見出しの制約を満たしたら完了です。issueに記載されたmarkdownlintコマンドを実行してください。

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

説明

curriculum documentation quality

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

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 6.3 (1,433 words, 17 concepts) ≤ 800 words, ≤ 15 concepts −3.7
active_learning 2.1 (density 0.63) ≥ 3 density (score 10) −7.9

(The missing_checkpoint and scaffolding flags are scorer false positives — the page has both; see the scorer issue.)

Root Cause (≤ 2 sentences):
The page is the longest in the corpus (≈2× the 706-word median) and presents ~10 tools and environments as parallel reference entries, each with a screenshot, with only two code blocks. Nearly all content is passive reading.

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 presenting many novel elements simultaneously overloads working memory, and Mayer's segmenting principle recommends splitting content into learner-paced chunks. A long glossary of ten tools has high element interactivity-free but high volume load, and without retrieval practice (e.g. matching exercises) little is encoded.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md to reduce it to ≤ 900 words without losing facts: collapse the per-tool "Conceptual screenshots" sections into a single table (Tool | Role | When you use it | Docs) or move rarely needed tools (Claude, OpenAI Codex) into <details> blocks. Add one short active exercise, e.g. a "match the tool to its role" checklist or a terminal block running `gh --version`, `git --version`, `gh aw --version`. Keep the :clipboard: Before You Start and :white_check_mark: Checkpoint sections, keep second-person tone, do not number headings, and keep callouts ≤ 3. Run `npx --yes markdownlint-cli2 "workshop/side-quest-01-02-environment-reference.md"`.

Expected Score After Fix: 5.5 / 10.0 with current scorer (≈ 8.0 once the checkpoint/scaffolding regex defect is fixed)

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

  • expires on Nov 6, 2026, 3:32 AM UTC
主要言語
JavaScript
スター
58
フォーク
40
平均マージ
4日 4時間
マージ済み PR（30日）
8

環境構築

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