Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

[workshop-sync] side-quest-06-02-cca-codespace.md: broken cross-reference and risky install order for org-owned Codespaces

オープン 初心者向け
  • 何か問題がありますか？
#3,969 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
84/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
github, shell
領域
documentation

調査の方向性

まず 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 の本文から書いたものです。

説明

documentation

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.md has no "Open a Codespace first" button/section to link to; the actual Codespace-launch step is 02a-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

  1. Update the "Open a Codespace" step to link to 02a-setup-codespace.md#open-the-codespace (or add the referenced button/section to 06-install-gh-aw.md if one is intended to exist there).
  2. Reorder the install instructions to lead with the curl install script as primary, keeping gh extension install/gh extension upgrade as the fallback for non-org-owned Codespaces, consistent with 06-install-gh-aw.md and side-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分
マージ済み PR（30日）
25

環境構築

このプロジェクトの環境構築ファイルはまだ確認していません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

githubnext/gh-aw-workshop のほかの issue

githubnext/gh-aw-workshop の issue をすべて見る

似ている issue

JavaScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。