registrystack / registrystack/registry-stack
Make published Start pages discoverable and gate orphan routes
- Lingua principale
- Rust
- Stelle
- 2
- Fork
- 0
- Merge medio
- 2h 55m
- PR unite (30g)
- 130
Descrizione
## Context
PR #508's documentation review found that `docs/site/src/content/docs/start/quickstart.mdx` is published but has no inbound documentation link or sidebar entry. The existing information-architecture test proves that configured sidebar slugs resolve, but it does not detect a published page that becomes orphaned. `credential-tour.mdx` is currently draft and is not part of the published-page problem.
This is useful documentation hardening, but it is not a correctness or security blocker for PR #508.
## Desired outcome
- Decide whether the published quickstart is a supported entry point, a redirect, or should become draft/removed.
- If supported, give it one intentional task-oriented navigation path without duplicating the generated first-country journey.
- Add a small reverse information-architecture gate that detects newly orphaned published pages while allowing an explicit, reviewed exception list for machine-only or redirect pages.
- Keep archived docsets and docset-relative links working.
## Definition of done
- Every published Start page is either intentionally reachable or explicitly exempted with rationale.
- A planted orphan-page negative control makes the architecture test fail.
- Current and archived documentation checks pass.
- No new onboarding path competes ambiguously with the primary journey.
Guida per i contributori
Apri la guida per i contributori
Direzione di ricerca
Inizia da docs/site/src/content/docs/start/quickstart.mdx e dal test di information architecture esistente descritto nell'issue; esamina come sono rappresentate le pagine pubblicate, gli slug della sidebar, i docset archiviati e i link relativi. Decidi lo stato intenzionale e il percorso di navigazione del quickstart, quindi verifica che il controllo negativo di orphan inserito fallisca, mentre i controlli della documentazione corrente e archiviata abbiano esito positivo.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Valutazione
- Ambito
- documentation, testing
- Tipo di issue
- Funzionalità
- Difficoltà
- 4/5
- Tempo stimato
- 3-5 giorni
- Stato di attività
- Tranquilla
- Chiarezza
- Abbastanza chiara
- Idoneità per principianti
- 48/100