[ordering-review] workshop order graph: 1 side-quest ordering issue, 3 benign cycles

Aperta Adatta ai principianti
#5,790 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

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

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_installed and gh_authenticated are provided by 02a (or 02-SQ01).
  • gh aw commands require 06 (extension installed) and 07's gh aw init.
  • 05/05b and 07/07d have reciprocal before/next edges (see cycles).

Cycles, feedback loops and weird cycles

All three are benign:

  1. 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.
  2. 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.
  3. 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

Apri in Codespaces

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

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di githubnext/gh-aw-workshop

Tutte le issue di githubnext/gh-aw-workshop

Issue simili

Altre issue su JavaScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.