Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

[curriculum-eval] side-quest-01-02-environment-reference.md: cognitive_load & active_learning — 1433-word glossary with 9 backloaded, low-interact

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

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

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

評価

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

調査の方向性

workshop/side-quest-01-02-environment-reference.md を開き、Conceptual screenshots セクション、用語集の表、既存の Checkpoint セクションを確認してください。まず 2 つのツールグループと用語集の文言を確認し、その後、完成したページに折りたたみ可能なグループと中間セルフチェックがあり、長さが短縮され、画像の alt text と Checkpoint の内容が変更されていないことを確認してください。

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

説明

curriculum documentation quality

File: workshop/side-quest-01-02-environment-reference.md
Overall Score: 4.93 / 10.0 (corpus mean: 6.09) — lowest-scoring file in the corpus
Corrected Overall Score (after fixing the checkpoint/scaffolding regex bug reported separately): 7.68 / 10.0 — still below corpus mean even after correction, driven by genuine content issues below.

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 6.3 ≤800 words -1.7 (1433 words, ~1.8× the 800-word target)
active_learning 2.1 density ≥ 3 -0.9 (density 0.63; only 2 code blocks + 7 checklist items across 1433 words)

Root Cause (≤ 2 sentences):
This page is structured as a long, mostly-passive glossary + 9 stacked conceptual screenshots (one per tool), which pushes word count to 1433 (79% over the 800-word cognitive-load ceiling) while offering almost no interactive checkpoints until the very end. Learners read through ~9 sequential image/description pairs with no intermediate "try this" or self-check prompts, so engagement is backloaded entirely into the final checkpoint.

Evidence (quoted from the file):

"You use Codespaces when you want a ready-to-go development environment in your browser."
"You use VS Code to browse files, edit workflows, and keep a terminal open beside your work."
"You use the terminal whenever the workshop asks you to run gh, gh aw, or git commands."

These three one-line captions (one of nine similar patterns) repeat the same "You use X when Y" template across 9 tools with no intervening activity, quiz, or interaction — pure exposition.

Learning Science Rationale:
Mayer's Multimedia Principle holds that pairing images with words aids learning, but the Coherence Principle (an extension of Mayer's framework) warns that extraneous or repetitive material — here, 9 near-identical image+caption pairs in a row — increases extraneous cognitive load without adding germane processing. Sweller's Cognitive Load Theory similarly predicts that long, low-interactivity stretches consume working memory on content organization rather than on schema construction, especially harmful on a reference page meant for quick lookup rather than deep study.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md to reduce passive reading load and raise interactivity:

1. Split the "Conceptual screenshots" section (9 stacked tool cards) into two collapsible <details> groups — "Development environments" and "Workshop tools and model options" — so learners can expand only the tools they need instead of scrolling through all 9 sequentially. The existing subheadings already group them this way; wrap each group's cards in a single <details><summary>Development environments</summary> ... </details> block.

2. After the "Environment and tool glossary" table, add one short self-check activity, e.g. a 3-item matching exercise ("Match each term to its role") using a <details><summary>Check your answers</summary> reveal block, to raise activity_density before the final checkpoint.

3. Trim the glossary table's "What it means in this workshop" column to one clause per row where it currently spans two clauses, to bring total word count closer to 800-1000.

Preserve the existing Checkpoint section and all image alt text unchanged.

Expected Score After Fix: ≈8.7 / 10.0 (assuming the checkpoint/scaffolding regex fix from the companion tooling issue is also applied; word count and activity density improvements alone would raise cognitive_load and active_learning by roughly 2-3 points each).

Generated by 🔬 Curriculum Quality Evaluator · copilot · auto · 147.3 AIC · ⌖ 18.6 AIC · ⊞ 9K · ◷

  • expires on Sep 28, 2026, 9:51 AM UTC
主要言語
JavaScript
スター
49
フォーク
20
平均マージ
7時間 55分
マージ済み PR（30日）
30

環境構築

このプロジェクトの環境構築ファイルはまだ確認していません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

githubnext/gh-aw-workshop のほかの issue

githubnext/gh-aw-workshop の issue をすべて見る

似ている issue

JavaScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。