Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

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

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

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

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

调研方向

首先阅读 workshop/side-quest-01-02-environment-reference.md,并 grep workshop/ 中以它的锚点为首的链接。编辑该文件,将散文替换为 term|role|when-you-use-it 表格,将 enterprise 注释移到 <details> 块中,并添加 gh --version 自检。当文件 ≤900 词、锚点保留且 npx --yes markdownlint-cli2 通过时完成。

由索引模型根据 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 ≥ 9 (≤ 800 words) −2.7
active_learning 2.1 ≥ 10 (density ≥ 3) −7.9

(checkpoint_quality 0.0 / scaffolding 5.0 are rubric artifacts — see the separate rubric-regex issue.)

Root Cause (≤ 2 sentences):
At 1433 words (2× the corpus median of 706) and 17 concepts, this reference page has only 2 code blocks and 7 checklist items, so activity density is 0.63. It mixes a glossary, screenshots and enterprise notes in a single linear read.

Evidence (quoted from the file):

"This is a reference page — you can read it any time. Come back here whenever the workshop uses a term you want to clarify."

Learning Science Rationale:
Sweller's Cognitive Load Theory and the Segmenting principle (Mayer) suggest long reference material should be chunked so learners look up only what they need. A glossary has legitimately low activity density, but splitting it lowers per-page load and makes anchor-links from lessons land on shorter pages.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md (a reference page, Bloom level "remember"). Reduce it to ≤ 900 words by (a) replacing prose descriptions with a compact term | role | when-you-use-it table, (b) moving the enterprise-hostname and OpenAI Codex/Claude model notes into short <details> blocks, and (c) keeping every existing heading anchor that other workshop pages link to (grep workshop/ for "side-quest-01-02-environment-reference.md#" first). Add a quick self-check (one code block with `gh --version`, `git --version`) near the top so density rises. Keep the ":white_check_mark: Checkpoint" section. Run `npx --yes markdownlint-cli2 "workshop/side-quest-01-02-environment-reference.md"`.

Expected Score After Fix: 6.0 / 10.0 (≈ 8.0 once the rubric regex fix lands)

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

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

环境准备

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