fix(seo): enforce trailing slashes on internal links to fix 134 non-indexable canonicals

[sfanahata]

DESCRIBE YOUR PR

Fixes 134 non-indexable canonical issues where pages point their canonical tag to a URL that triggers a redirect (missing trailing slash → trailing slash), creating broken canonical chains that confuse Google's indexation.

Root cause

The site is configured with trailingSlash: true (in both next.config.ts and vercel.json), meaning all canonical URLs include a trailing slash. However, hundreds of internal links in content files were authored without trailing slashes. When followed, these trigger a 308 redirect to the trailing-slash version, creating a chain between the link and the canonical URL that degrades SEO signals.

Changes

1. SmartLink trailing slash normalization (src/components/smartLink.tsx, src/utils.ts)

• Added ensureTrailingSlash() utility to src/utils.ts (alongside the existing stripTrailingSlash())
• Applied it in SmartLink for all internal page links at render time
• Skips mailto: and other scheme-based URLs, and static file paths with extensions (e.g. .pdf)
• This prevents future regressions — any link authored without a trailing slash is automatically normalized before rendering
• Preserves hash fragments (#section) and query strings (?param=value)
• Added 10 unit tests in src/utils.test.ts

2. Content link cleanup (366 files across docs/, includes/, platform-includes/)

• Fixed 732 lines where markdown links ([text](/path)) and <PlatformLink to="/path"> usages were missing trailing slashes
• Belt-and-suspenders with fix JavaScript docs don't reference the right version #1 — source content now matches canonical form

3. MD export canonical URLs (scripts/generate-md-exports.mjs)

• Fixed canonical URL construction to include trailing slashes, matching the behavior of generateMetadata() in page.tsx and mdToCanonicalPath() in middleware.ts

4. Deduplication (app/sitemap.ts)

• Replaced the inline appendSlash() helper with the shared ensureTrailingSlash() from src/utils.ts

Verification

• All 234 tests pass (including 10 new ensureTrailingSlash tests)
• ESLint: 0 errors
• TypeScript: compiles clean
• Prettier: all files formatted

IS YOUR CHANGE URGENT?

• Urgent deadline (GA date, etc.)
• Other deadline
• None: Not urgent, can wait up to 1 week+

PRE-MERGE CHECKLIST

• Checked Vercel preview for correctness, including links
• PR was reviewed and approved by any necessary SMEs (subject matter experts)
• PR was reviewed and approved by a member of the Sentry docs team

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
develop-docs	Ready	Preview	Aug 10, 2026 7:16pm
sentry-docs	Ready	Preview	Aug 10, 2026 7:16pm

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit f42310b. Configure here.}

[cursor]

Extension check scans query and hash

Medium Severity

hasFileExtension runs against the full href, including query strings and hashes. A page link whose query or fragment ends in a file-like suffix (for example .js or .json) is treated as a static file and skips ensureTrailingSlash, so those internal links still miss the trailing slash and can hit the same redirect/canonical issue this PR aims to fix.

 

^{Reviewed by Cursor Bugbot for commit f42310b. Configure here.}