[curriculum-eval] side-quest-01-02-environment-reference.md: cognitive_load — 1,536 words and 19 concepts in one reference page

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

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

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

評価

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

調査の方向性

workshop/side-quest-01-02-environment-reference.md から始めてください。移動または削減すべき部分は、Docs列を含む用語集の表と「Conceptual screenshots」セクションです。用語集の後に「Try it」コマンドブロックを追加し、新しいページを追加する場合は workshop/README.md を更新してください。ページが900語未満で、新しいページが存在してリンクされ、npx markdownlint-cli2 "**/*.md" が通れば完了です。

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

説明

curriculum documentation quality

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

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 5.3 ≥ 8 (≤ 800 words, ≤ 15 concepts) −2.7 (1,536 words, 19 concepts)
active_learning 2.4 density ≥ 3 −0.6 (density 0.72)

(checkpoint_quality 0.0 and scaffolding 5.0 are false negatives from the rubric regex; the page has both sections.)

Root Cause (≤ 2 sentences):
The page puts a long glossary table and a long run of "conceptual screenshots" on one page (1,536 words, about 2x the 800-word ideal), with little learner action beyond the checkpoint. It is the lowest-scoring page in the corpus and trending slightly down (4.93 → 4.79).

Evidence (quoted from the file):

| GitHub Codespaces | Your cloud development environment when you choose the browser-based setup path. Pre-launched in golden-ticket workshops. | Steps 2–14: writing, compiling, and running workflows | GitHub Codespaces docs |

Learning Science Rationale:
Sweller's Cognitive Load Theory predicts that a dense four-column table with an external link in every row raises extraneous load and splits attention. Mayer's segmenting and coherence principles suggest splitting the reference into smaller chunks and dropping redundant material. Short "try it" checks (gh --version) placed next to each tool would add retrieval practice.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md. Reduce it to under 900 words: move the "Conceptual screenshots" section into a new side quest page (e.g. side-quest-01-04-environment-screenshots.md) and link to it, and remove the "Docs" column from the glossary table, linking each tool name inline instead. Add a short "Try it" command block (gh --version, git --version, gh auth status) directly after the glossary. Keep the existing "Before You Start" and Checkpoint sections (use the :white_check_mark: shortcode heading). Update workshop/README.md if a page is added. Run: npx --yes markdownlint-cli2 "**/*.md".

Expected Score After Fix: 7.0 / 10.0

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

  • expires on Nov 15, 2026, 7:04 AM UTC
主要言語
JavaScript
スター
62
フォーク
43
平均マージ
11時間 26分
マージ済み PR（30日）
13

環境構築

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