[ordering-review] workshop order graph: 1 side-quest ordering issue, 3 benign cycles
I maintainer di solito rispondono entro 1 giorno
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 1/5
- Tempo stimato
- 1-3 ore
- Idoneità per principianti
- 88/100
- Tipo di issue
- Documentazione
- Chiarezza
- Specificata chiaramente
- Stato di attività
- Attiva
- Stack tecnologico
- github-actions, markdown
- Ambito
- content, documentation
Direzione di ricerca
Leggi workshop/side-quest-01-02-environment-reference.md e workshop/README.md per confermare dove si dirama la side quest e quando viene configurato Codespace. Aggiorna le istruzioni di verifica affinché chi apprende sappia di eseguire i controlli dopo aver completato la configurazione di Codespace, e modifica la nota sul branch nel README se opportuno. Il lavoro è completo quando a chi segue la side quest prima della configurazione viene detto chiaramente di considerare la pagina come riferimento finché non ha un Codespace.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
Graph health summary
Reviewed 98 pages (3 dispatcher pages), 346 edges, 59 heuristic findings, 3 cycles, 3 feedback loops and 3 weird cycles. After verifying the cited pages, 58 findings are false positives (details below). One real ordering problem remains. The full generated graph and constraint list are in order-review-report.md from the run artifacts. The condensed core path is below.
graph TD
w00["00 welcome"] --> p01["01 prerequisites"]
p01 --> s02a["02a setup codespace"]
p01 -.->|branch| sq0102["01-SQ02 environment reference"]
p01 -.->|branch| sq0201["02-SQ01 local terminal"]
s02a --> a04["04 actions intro"]
sq0201 --> a04
a04 --> a05["05 agentic intro"]
a05 --> a05b["05b security"]
a05b --> a05c["05c practice"]
a05c --> i06["06 install gh-aw"]
i06 --> f07["07 first workflow"]
f07 --> m07d["07d model access"]
m07d --> r08["08 run workflow"]
r08 --> r08b["08b interpret run"]
r08b --> e09["09 agentic editing"]
Ordering constraints (key ones)
- 01 → 02a (Codespace) or 02-SQ01 (local) → 04 → 05 → 05b → 05c → 06 → 07 → 07d → 08 → 08b → 09
environment_ready,gh_installedandgh_authenticatedare provided by 02a (or 02-SQ01).gh awcommands require 06 (extension installed) and 07'sgh aw init.- 05/05b and 07/07d have reciprocal before/next edges (see cycles).
Cycles, feedback loops and weird cycles
All three are benign:
- 05 ↔ 05b – 05b says "You've read What Are Agentic Workflows?" and 05 says "Next: How Agentic Workflows Stay Safe". This is a normal prev/next pair, not a loop.
- 07 ↔ 07d – 07d deliberately has two entry points (error recovery from 07, or the normal next step), and 07 links to it for troubleshooting. This is documented intentionally.
- 02a ↔ 02-SQ01 – these are alternative environment paths (Codespace vs local) that reference each other as options, not a sequential loop.
The 51 missing_prerequisite_link findings (gh_authenticated not linked to 02a on later steps) are heuristic false positives. All those pages sit after 02a and 06 in the linear path, and 06/07 already state the prerequisites.
Verified ordering problem
File: workshop/side-quest-01-02-environment-reference.md
Instruction that appears too early (section "Verify your tools are ready"):
Open a terminal in your Codespace and run:
gh --version/git --version/gh auth status
Missing earlier step: The side quest branches from Step 1 (link unavailable: invalid HTTPS URL) (per workshop/README.md), but the Codespace is not created until 02a-setup-codespace.md. The page's own "Before You Start" says "No terminal required", yet the checkpoint section asks learners to open a Codespace terminal and run gh/gh auth status. It also says "If any command fails, see Set Up a Codespace", which points forward to a step the learner may not have done.
Why it confuses learners: A learner who follows the side quest right after Step 1 has no Codespace or terminal to open, so the verification looks broken or leads them to skip the check.
Suggested fix:
- Change the intro to: "Do this verification after you finish Set Up a Codespace (link unavailable: invalid HTTPS URL); until then, treat this page as read-only reference."
- Replace "Open a terminal in your Codespace and run:" with "After completing Set Up a Codespace, open its terminal and run:".
- Optionally move the README branch note to "branches from Step 2a".
This issue is ready for an agent to resolve.
Generated by 🧭 Workshop Order Review · copilot · auto · ~27 AIC · ⌖ ~1 AIC · ⊞ 4.8K · ◷
- expires on Nov 17, 2026, 11:07 AM UTC
- Lingua principale
- JavaScript
- Stelle
- 62
- Fork
- 43
- Merge medio
- 11h 26m
- PR unite (30g)
- 13
Preparare l'ambiente
Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.
- Nessun Dockerfile né file Docker Compose
- Nessun modello di pull request
- Nessuna guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di githubnext/gh-aw-workshop
-
curriculum documentation quality
Difficoltà 2/5 1-3 ore Idoneità per principianti 76/100
githubnext/gh-aw-workshop#5779 ·
I maintainer di solito rispondono entro 1 giorno
-
curriculum documentation quality
Difficoltà 2/5 1-3 ore Idoneità per principianti 87/100
githubnext/gh-aw-workshop#5780 ·
I maintainer di solito rispondono entro 1 giorno
-
curriculum documentation quality
Difficoltà 2/5 1-3 ore Idoneità per principianti 76/100
githubnext/gh-aw-workshop#5777 ·
I maintainer di solito rispondono entro 1 giorno
-
curriculum documentation quality
Difficoltà 2/5 1-3 ore Idoneità per principianti 88/100
githubnext/gh-aw-workshop#5776 ·
I maintainer di solito rispondono entro 1 giorno
-
curriculum documentation quality
Difficoltà 2/5 1-3 ore Idoneità per principianti 86/100
githubnext/gh-aw-workshop#5774 ·
I maintainer di solito rispondono entro 1 giorno
Tutte le issue di githubnext/gh-aw-workshop
Issue simili
-
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 69/100
I maintainer di solito rispondono entro 1 giorno
-
automation chore ci-cd consistency developer-experience difficulty: easy discoverability documentation enhancement github-actions good first issue help wanted hygiene priority: P3 seo shell yaml
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 76/100
-
bug
Difficoltà 2/5 1-3 ore Idoneità per principianti 84/100
swc-project/swc-next-issues#394 ·
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
adobe/helix-tools-website#480 ·
I maintainer di solito rispondono entro 1 giorno
-
area: docs area: tests bug cloudflare cloudflare-workers consistency developer-experience difficulty: easy dx good first issue help wanted hygiene javascript priority: P3 quality tech: javascript tests
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
flisk-sh/readme-diagram#11 ·