Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

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

Abierto Apto para principiantes
#3,969 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
84/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
github, shell

Línea de trabajo

Empieza por workshop/side-quest-06-02-cca-codespace.md y luego compara los pasos referenciados en workshop/06-install-gh-aw.md, workshop/02a-setup-codespace.md y workshop/side-quest-06-01-install-troubleshooting.md. Verifica que el enlace de Codespace resuelva a la sección indicada y que el orden de instalación documentado coincida con las indicaciones sobre Codespaces propiedad de la organización.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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
Lenguaje dominante
JavaScript
Estrellas
49
Forks
20
Merge medio
7 h 12 min
PR fusionados (30 d)
26

Preparar el entorno

Aún no hemos revisado los archivos de configuración de este proyecto. Empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de githubnext/gh-aw-workshop

Todos los issues de githubnext/gh-aw-workshop

Issues similares

Más issues de JavaScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.