[curriculum-eval] side-quest-01-02-environment-reference.md: active_learning — 1433-word glossary with density 0.63

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

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

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

評価

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

調査の方向性

workshop/side-quest-01-02-environment-reference.mdを読み、用語集、「Conceptual screenshots」、Checkpoint セクションに注目してください。ワークショップのステップ01～07で使われている用語だけを用語集に残し、スクリーンショットのセクションを簡潔にするか分割して、期待される出力を添えた短いコマンドチェックを3～4個追加してください。「Checkpoint」セクションと「Before You Start」セクションは残してください。markdownlint-cli2を実行し、ページが900語以内であることを確認してください。

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

説明

curriculum documentation quality

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

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 6.3 ≥ 8 (≤ 800 words) −1.7 (1433 words, 17 concepts)
active_learning 2.1 10 (density ≥ 3) −7.9 (density 0.63)

(missing_checkpoint is a false positive; the page has ## :white_check_mark: Checkpoint at line 155.)

Root Cause (≤ 2 sentences):
The lowest-scoring page is a reference glossary nearly twice the word guideline, with a "Conceptual screenshots" section (lines 54–154) dominating the page. Only 2 code blocks and 7 checklist items support 1433 words.

Evidence (quoted from the file):

When you're ready to verify your tools are working, see the Checkpoint (link unavailable: invalid HTTPS URL) section at the bottom.

Learning Science Rationale:
Mayer's coherence and segmenting principles argue that long reference material should be broken into learner-paced pieces and stripped of non-essential content; Cognitive Load Theory predicts novices cannot retain a 1400-word glossary without applying it. Adding short "try it" commands converts passive reference into retrieval practice.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md. Reduce to ≤ 900 words by tightening the glossary (keep only terms used in workshop steps 01–07) and condensing or splitting the "Conceptual screenshots" section into a collapsed <details> or a separate side quest. After the glossary add 3–4 short "check it yourself" code blocks (e.g. `gh --version`, `git --version`) with expected output. Keep the Checkpoint with ≥ 4 items and the Before You Start section; update workshop/README.md if you add a file; run markdownlint-cli2.

Expected Score After Fix: 6.8 / 10.0

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

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