René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"fix(seo): consolidate versioned library landing pages onto /latest","articleBody":"## Problem\n\nThe recent latest-version redirect work correctly handles documentation routes, but product-specific landing routes bypass the shared /_library/$libraryId/$version parent.\n\nLive examples currently returning 200 with self-referencing canonicals:\n\n- /query/v5 and /query/latest\n- /router/v1 and /router/latest\n- /ai/v0 and /ai/latest\n\nThis leaves duplicate landing pages even though nested latest-version docs correctly return 308.\n\nThe product-specific routes call beforeLoadLibraryLanding in src/routes/-library-landing-route.tsx. That helper validates a version but does not redirect library.latestVersion to latest. The current latest-version check in src/routes/_library/$libraryId/$version.tsx does not govern these static landing routes.\n\nGoogle canonical guidance: https://developers.google.com/search/docs/crawling-indexing/consolidate-duplicate-urls\n\n## Desired behavior\n\n- /{library}/{library.latestVersion} permanently redirects with 308 to /{library}/latest.\n- Preserve the remainder of the request URL where applicable, including meaningful search parameters.\n- Every indexable library landing page, including historical numbered landing pages that remain accessible, declares /{library}/latest as its canonical landing URL.\n- og:url and twitter:url match the /latest canonical.\n- No numbered library landing page self-canonicalizes.\n- Existing historical documentation behavior remains unchanged: historical docs may remain accessible and use their current path-aware canonical logic.\n\n## Acceptance criteria\n\n- The shared product landing helper enforces the latest-numbered-version redirect for every product-specific landing route.\n- Tests cover at least Query, Router, AI, and one library with non-v1 latestVersion metadata.\n- /query/v5, /router/v1, and /ai/v0 return 308 to their /latest equivalents in an integration test.\n- Historical landing pages that return 200 emit only one canonical link, pointing to /latest.\n- /latest landing pages self-canonicalize and remain 200.\n- Sitemap entries continue to contain only /latest library landing pages.\n- Stable unversioned aliases such as /query are reviewed and use a permanent redirect when their mapping to /latest is intentional.","author":{"url":"https://github.com/KevinVandy","@type":"Person","name":"KevinVandy"},"datePublished":"2026-08-14T12:54:32Z","url":"https://github.com/TanStack/tanstack.com/issues/1150"}