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

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

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

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

評価

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

調査の方向性

Start with workshop/side-quest-01-02-environment-reference.md and check its current length, anchors, glossary, and checkpoint. Follow the prompt to keep existing anchors working, move the AI tool and enterprise details into a collapsed <details> section or a linked sibling page, and add the two gh exercises. Keep at least four checkpoint items; if you add a page, update workshop/README.md. Done when the page is at most 900 words and the requested content and links are preserved.

索引モデルが 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 (1,536 words, 19 concepts) ≤ 800 words, ≤ 15 concepts −4.7
active_learning 2.4 (density 0.72) density ≥ 3 −7.6
scaffolding 5.0 10 −5 (detector; page does have a Before You Start section)

(checkpoint_quality is reported as 0 only because of the regex defect tracked separately; the page has 7 checklist items.)

Root Cause (≤ 2 sentences):
A single reference page packs the entire tool/environment glossary, enterprise notes and Claude/AI-tool sections into ~1.9× the word budget. The only hands-on activity is the checkpoint, so density is 0.72 vs 3.

Evidence (quoted from the file):

This is a reference page — you can read it any time. Come back here whenever the workshop uses a term you want to clarify. No terminal required to read this page.

Learning Science Rationale:
Sweller's Cognitive Load Theory predicts that exceeding working-memory capacity with many novel, unconnected terms hurts schema formation; chunking and segmenting (Mayer's segmenting principle) reduce extraneous load. Splitting the glossary into focused pages and adding a short check-your-tools exercise gives learners immediate retrieval practice per chunk.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md. Keep all current anchor IDs (e.g. #claude) working because other pages link to them. Reduce the page to ≤ 900 words by moving AI-tool/model detail (Claude, OpenAI, etc.) and enterprise hostname notes into a collapsed <details> section or a new sibling side quest, linking to it. Add two short hands-on code blocks (gh --version, gh auth status) inline next to the relevant glossary rows to raise activity density. Keep the "## :white_check_mark: Checkpoint" section with ≥ 4 items. Do not number headings. Run `npx --yes markdownlint-cli2 "**/*.md"` and update workshop/README.md if a file is added.

Expected Score After Fix: 6.5 / 10.0 (≈ 8.0+ once the checkpoint regex is fixed)

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

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