registrystack / registrystack/registry-stack

Make published Start pages discoverable and gate orphan routes

Aperta
#509 2 commenti 0 reazioni 0 assegnatari Vedi su GitHub
criticality:p3 documentation post-1.0 triage:roadmap
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

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.