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

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

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

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

调研方向

阅读 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 小时
30 天内合并 PR
7

环境准备

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