[curriculum-eval] side-quest-01-02-environment-reference.md: cognitive_load — 1,433-word passive glossary, activity density 0.63

已关闭
  • 哪里不对？
#4,639 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
3/5
预计耗时
1-2 天
新手友好度
68/100
Issue 类型
文档
描述清晰度
基本清楚
活跃度
活跃
技术栈
git, github
领域
content, documentation

调研方向

Start with workshop/side-quest-01-02-environment-reference.md, where the glossary and the 'Conceptual screenshots' section sit between the Before You Start and Checkpoint sections, and check the 800-word target against its roughly 1,433 words. Split it into two linked pages, add a runnable gh --version and git --version step with expected output to each tool entry, and update workshop/README.md if a file is added. Done when each page is under 800 words, the checkpoint sections are kept, and npx --yes markdownlint-cli2 "**/*.md" passes.

由索引模型根据 Issue 内容生成。

描述

curriculum documentation quality

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

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 6.3 10 (<= 800 words) -3.7 (1433 words, 17 concepts)
active_learning 2.1 10 (density >= 3) -7.9 (density 0.63)

The flagged missing_checkpoint was dismissed: the file has a 7-item checkpoint; this is a rubric regex bug (see the checkpoint regex issue).

Root Cause (<= 2 sentences):
The page is a ~1,400-word glossary plus a long "Conceptual screenshots" section (lines 54-155) with only 2 code blocks, so it is mostly passive reading. Concepts are listed together without interleaved tasks.

Evidence (quoted from the file):

Environment and tool glossary ... ## Conceptual screenshots

Learning Science Rationale:
Sweller's Cognitive Load Theory predicts that long, undifferentiated reference text raises extraneous load, and the testing effect says short retrieval tasks beat re-reading. Splitting the glossary and adding small verify-it commands lowers load and raises engagement.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md: split it so each page is <= 800 words (for example glossary vs. conceptual screenshots, linked to each other), keep the Before You Start and :white_check_mark: Checkpoint sections, and add a short runnable command per tool (gh --version, git --version) with expected output. Use second person, update workshop/README.md if a file is added, and run npx --yes markdownlint-cli2 "**/*.md".

Expected Score After Fix: 6.5 / 10.0 (about 8.5 after the checkpoint regex fix)

Generated by 🔬 Curriculum Quality Evaluator · copilot · auto · 27.2 AIC · ⌖ 0.785 AIC · ⊞ 10.5K · ◷

  • expires on Oct 17, 2026, 7:40 AM UTC
主要语言
JavaScript
星标
56
派生
40
平均合并
2 天 14 小时
30 天内合并 PR
13

环境准备

在 Codespaces 中打开

在浏览器里用你自己的 GitHub 账号启动这个项目的开发容器。

  • 没有 Dockerfile 或 Docker Compose 文件
  • 没有 Pull Request 模板
  • 没有贡献指南

从这里开始

  1. 先读完整个 Issue，再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库，在一个分支上完成修改。
  4. 提交 Pull Request，并在描述里引用这个 Issue 编号。

githubnext/gh-aw-workshop 的其他 Issue

查看 githubnext/gh-aw-workshop 的全部 Issue

相似的 Issue

更多 JavaScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。