registrystack / registrystack/registry-stack

Make published Start pages discoverable and gate orphan routes

Open
#509 2 comments 0 reactions 0 assignees View on GitHub
criticality:p3 documentation post-1.0 triage:roadmap
Dominant language
Rust
Stars
2
Forks
0
Avg merge
2h 55m
Merged PRs (30d)
130

Description

## 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.

Contributor guide

Open the contributing guide

Research direction

Start with docs/site/src/content/docs/start/quickstart.mdx and the existing information-architecture test described in the issue; inspect how published pages, sidebar slugs, archived docsets, and relative links are represented. Decide the quickstart's intentional status and navigation path, then verify the planted orphan negative control fails while current and archived documentation checks pass.

Written by the indexing model from the issue text.

Assessment

Domain
documentation, testing
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.