[curriculum-eval] side-quest-01-02-environment-reference.md: cognitive_load — 1433-word glossary with 17 concepts and low activity density

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

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

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

評価

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

調査の方向性

workshop/side-quest-01-02-environment-reference.mdとリンク先のside-quest-enterprise-setup.mdを読み、リポジトリのAGENTS.mdの規約に従ってください。重複する概念的なスクリーンショットの内容を用語集に統合し、Enterpriseのホスト名マッピングをリンク付きで移動して、コマンドのチェックを4つ追加してください。指定された2つのセクションには、それぞれ具体的なチェック項目を少なくとも4つ残してください。ドキュメントが語数と概念数の上限を満たすことを確認し、指定されたMarkdown lintコマンドを実行してください。

索引モデルが 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 ≥ 8 (≤ 800 words, ≤ 15 concepts) −1.7 (1433 words, 17 concepts)
active_learning 2.1 ≥ 10 (density ≥ 3) −7.9 (density 0.63)
checkpoint_quality 0.0 (false positive, see note) 10 n/a
scaffolding 5.0 (likely false positive) 10 n/a

Note: the file does have ## :white_check_mark: Checkpoint (7 items) and ## :clipboard: Before You Start; the rubric regexes only recognise the emoji characters, not the shortcodes. The missing-checkpoint flag is dismissed. The length and activity-density flags are confirmed.

Root Cause (≤ 2 sentences):
The page is a reference glossary with a long "Conceptual screenshots" section (lines 54–154) that repeats the glossary and has only 2 code blocks, so words far outnumber learner actions.

Evidence (quoted from the file):

Environment and tool glossary ... ## Conceptual screenshots

Learning Science Rationale:
Sweller's Cognitive Load Theory predicts that long, passive reference material pushes extraneous load past working-memory limits, and Mayer's Redundancy Principle says duplicating the same information in text and graphics hurts learning. Splitting the glossary and the screenshots, and attaching small verification actions to each, lowers load and raises engagement.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md. Reduce it to ≤ 800 words and ≤ 15 distinct new concepts: merge the "Conceptual screenshots" section into the glossary (one image per tool, no duplicated prose) and move the enterprise hostname mapping into side-quest-enterprise-setup.md with a link. Add at least 4 short "run this command and confirm the output" code blocks (gh --version, git --version, gh aw --version, gh auth status). Keep the "Before You Start" and "## :white_check_mark: Checkpoint" sections with ≥ 4 specific items. Follow AGENTS.md conventions and run npx --yes markdownlint-cli2 "**/*.md".

Expected Score After Fix: 6.5 / 10.0 (rubric as implemented; about 8 once checkpoint detection is fixed)

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

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

環境構築

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