[workshop-sync] side-quest-06-02-cca-codespace.md: broken cross-reference and risky install order for org-owned Codespaces
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 2/5
- 预计耗时
- 1-3 小时
- 新手友好度
- 84/100
- Issue 类型
- 文档
- 描述清晰度
- 描述清楚
- 活跃度
- 活跃
- 技术栈
- github, shell
调研方向
先从 workshop/side-quest-06-02-cca-codespace.md 开始，然后比较 workshop/06-install-gh-aw.md、workshop/02a-setup-codespace.md 和 workshop/side-quest-06-01-install-troubleshooting.md 中引用的步骤。验证 Codespace 链接是否解析到所述部分，以及文档记录的安装顺序是否与组织拥有的 Codespaces 指南一致。
由索引模型根据 Issue 内容生成。
描述
Workshop file reviewed
workshop/side-quest-06-02-cca-codespace.md
Problem
The "Open a Codespace" instructions say:
From Step 6, select the Codespaces button in the
Open a Codespace first (GitHub Copilot Cloud Agent users) section.
workshop/06-install-gh-aw.md currently has no such section or heading ("Open a Codespace first (GitHub Copilot Cloud Agent users)") and no Codespaces button. That file only lists a prerequisite link to Set Up a Codespace under "Before You Start". This is a broken cross-reference that will leave CCA-journey learners unable to find the described button.
Additionally, this side quest's "Install gh-aw in the Codespace terminal" section leads with:
gh extension install github/gh-aw
as the primary install command. But 06-install-gh-aw.md itself states: "In org-owned Codespaces the GitHub token is scoped to the org and cannot access the extension marketplace, so the curl script is the reliable path," and side-quest-06-01-install-troubleshooting.md has a dedicated "Organization Codespace token limitation (HTTP 403)" section describing exactly this failure. Since CCA users are commonly working in org-owned Codespaces, leading with gh extension install risks an avoidable HTTP 403 for this exact audience.
Current correct behaviour
06-install-gh-aw.mdhas no "Open a Codespace first" button/section to link to; the actual Codespace-launch step is02a-setup-codespace.md("Open the Codespace").- The install script (
curl -sL https://raw.githubusercontent.com/github/gh-aw/main/install-gh-aw.sh | bash) is the workshop's documented reliable path for org-owned Codespaces.
Suggested fix
- Update the "Open a Codespace" step to link to
02a-setup-codespace.md#open-the-codespace(or add the referenced button/section to06-install-gh-aw.mdif one is intended to exist there). - Reorder the install instructions to lead with the curl install script as primary, keeping
gh extension install/gh extension upgradeas the fallback for non-org-owned Codespaces, consistent with06-install-gh-aw.mdandside-quest-06-01-install-troubleshooting.md.
Generated by 🔍 Workshop Sync Check · copilot · auto · 158.7 AIC · ⌖ 6.75 AIC · ⊞ 8.2K · ◷
- expires on Sep 30, 2026, 8:58 AM UTC
- 主要语言
- JavaScript
- 星标
- 49
- 派生
- 20
- 平均合并
- 9 小时 44 分钟
- 30 天内合并 PR
- 25
环境准备
我们还没有检查这个项目的环境配置文件。先看它的 README，通用步骤见我们的新手贡献指南。
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
githubnext/gh-aw-workshop 的其他 Issue
-
documentation
难度 1/5 1 小时以内 新手友好度 92/100
githubnext/gh-aw-workshop#3968 ·
维护者通常 1 天内回复
-
agentic-workflows documentation workflow-editor
难度 2/5 1-3 小时 新手友好度 78/100
githubnext/gh-aw-workshop#3966 ·
维护者通常 1 天内回复
-
feedback simulation workshop
难度 2/5 1-3 小时 新手友好度 82/100
githubnext/gh-aw-workshop#3964 ·
维护者通常 1 天内回复
-
documentation guidelines
难度 1/5 1 小时以内 新手友好度 95/100
githubnext/gh-aw-workshop#3959 ·
维护者通常 1 天内回复
-
documentation guidelines
难度 1/5 1 小时以内 新手友好度 90/100
githubnext/gh-aw-workshop#3960 ·
维护者通常 1 天内回复
查看 githubnext/gh-aw-workshop 的全部 Issue
相似的 Issue
-
feature task
难度 2/5 1-3 小时 新手友好度 72/100
RealDevSquad/website-www#1178 ·
-
难度 2/5 1-3 小时 新手友好度 68/100
netlify-labs/nax#56 · 2 条评论 · 1 个 reaction ·
-
accessibility bug revealjs
难度 2/5 1-3 小时 新手友好度 84/100
quarto-dev/quarto-cli#14961 ·
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 88/100
PnX-SI/GeoNature#4435 · 2 条评论 ·
维护者通常 1 天内回复
-
bug
难度 2/5 1-3 小时 新手友好度 85/100
openlayers/openlayers#17648 ·
维护者通常 1 天内回复