Skip to content

feat(docsite): suggest matching pages on 404s - #5669

Merged
nynexman4464 merged 1 commit into
mainfrom
nynexman4464/feat/404-suggestions
Aug 31, 2026
Merged

feat(docsite): suggest matching pages on 404s#5669
nynexman4464 merged 1 commit into
mainfrom
nynexman4464/feat/404-suggestions

Conversation

@nynexman4464

@nynexman4464 nynexman4464 commented Aug 28, 2026

Copy link
Copy Markdown
Contributor

Summary

  • expose canonical page titles from the existing sitemap and use them for 404 recovery
  • rank missing paths against URL segments and title words, with conservative confidence thresholds
  • show up to three accessible DidYouMean links when likely destinations exist
  • cache the community contributor lookup so /community prerenders successfully

Test plan

  • pnpm -F @astryxdesign/docsite test — 436 tests passed
  • pnpm -F @astryxdesign/docsite typecheck
  • pnpm -F @astryxdesign/docsite build — all 340 static pages generated, including /community
  • targeted ESLint and repository checks passed
  • /start remains a 404 and suggests Getting Started at /docs/getting-started
  • /new remains a 404 and suggests What's New at /changelog
  • /community returns 200
  • an unrelated missing path shows no low-confidence suggestion

/start → Getting Started

The Astryx 404 page suggesting Getting Started

/new → What's New

The Astryx 404 page suggesting What's New

@vercel

vercel Bot commented Aug 28, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
astryx Ready Ready Preview Aug 31, 2026 5:39pm

Request Review

@meta-cla meta-cla Bot added the CLA Signed This label is managed by the Meta Open Source bot. label Aug 28, 2026
@github-actions github-actions Bot added the needs:design-review Affects visuals — Design should review label Aug 28, 2026
@nynexman4464
nynexman4464 force-pushed the nynexman4464/feat/404-suggestions branch from 4cc6604 to 319c076 Compare August 28, 2026 22:01
@github-actions github-actions Bot removed the needs:design-review Affects visuals — Design should review label Aug 28, 2026
@nynexman4464
nynexman4464 force-pushed the nynexman4464/feat/404-suggestions branch from 319c076 to 2dc7bfc Compare August 31, 2026 16:55
github-actions Bot added a commit that referenced this pull request Aug 31, 2026
@github-actions

github-actions Bot commented Aug 31, 2026

Copy link
Copy Markdown
Contributor

PR Analysis Report

Current run: The current CI run completed, but its trusted analysis is unavailable. Preview links are not shown.


Generated by PR Enrichment workflow | View current CI run

@nynexman4464
nynexman4464 marked this pull request as ready for review August 31, 2026 17:33
@nynexman4464
nynexman4464 marked this pull request as draft August 31, 2026 17:34
@nynexman4464
nynexman4464 force-pushed the nynexman4464/feat/404-suggestions branch from 2dc7bfc to a626407 Compare August 31, 2026 17:34
github-actions Bot added a commit that referenced this pull request Aug 31, 2026
@nynexman4464
nynexman4464 marked this pull request as ready for review August 31, 2026 17:40
@nynexman4464
nynexman4464 merged commit d7bb4bf into main Aug 31, 2026
28 checks passed
@github-actions
github-actions Bot deleted the nynexman4464/feat/404-suggestions branch September 1, 2026 06:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA Signed This label is managed by the Meta Open Source bot.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants