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

已关闭 适合新手
#5,143 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
2/5
预计耗时
1-3 小时
新手友好度
74/100
Issue 类型
文档
描述清晰度
描述清楚
活跃度
活跃
技术栈
github-actions, javascript, markdown

调研方向

从 workshop/side-quest-01-02-environment-reference.md 开始,重点查看术语表和概念截图部分;如果内容拆分到了其他文件,也请查看 workshop/README.md。添加简短的终端练习命令及预期输出,同时确保每个部分不超过规定的字数限制,并保留至少四个可验证的检查点条目。运行 npx --yes markdownlint-cli2 "**/*.md";评估器的目标分数是 6.5。

由索引模型根据 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 ≤ 800 words +633 words over budget
active_learning 2.1 density ≥ 3 density 0.63 (−2.37)

Root Cause (≤ 2 sentences):
The page packs a glossary (lines 15–53) and a long "Conceptual screenshots" section (lines 54–154) into one file, giving 1,433 words with only 2 code blocks. It reads as reference material but has no practice tasks.

Evidence (quoted from the file):

Environment and tool glossary ... ## Conceptual screenshots

Learning Science Rationale:
Mayer's segmenting principle says complex material is learned better in learner-paced segments, and Sweller's CLT warns that long undifferentiated text raises extraneous load. Retrieval practice (Roediger & Karpicke) also shows that adding brief self-check tasks to reference content improves retention.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md. Split it into two files (glossary; conceptual screenshots) each ≤ 800 words, or collapse the screenshots section into <details> blocks. Add 2–3 short "try it" terminal commands with expected output so activity density ≥ 3 per 100 words. Keep the existing "## :white_check_mark: Checkpoint" with ≥ 4 verifiable items, update workshop/README.md if you add a file, run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: 6.5 / 10.0

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

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

环境准备

在 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 摘要。