Skip to content

docs: Point internal links directly at moved-page destinations - #19636

Open
coolguyzone wants to merge 1 commit into
masterfrom
coolguyzone/chore/fix-redirect-inlinks
Open

coolguyzone wants to merge 1 commit into
masterfrom
coolguyzone/chore/fix-redirect-inlinks

Conversation

@coolguyzone

@coolguyzone coolguyzone commented Sep 25, 2026 •

Copy link
Copy Markdown
Contributor

DESCRIBE YOUR PR

In my continued quest to get all the low-hanging fruit to help SEO and site performance, this PR removes redirect hops on internal links by pointing them directly at the intended destination. This was created programmatically with Claude, but I've made sure the links still work as intended.

  • 22 markdown/<Link> links across 19 files updated to their final URLs
  • Destinations resolved against production (docs.sentry.io), because this repo's redirects.js is stale in several spots (some destination fields now 404 or redirect again)
  • Fragments/anchors preserved (e.g. …/trace-propagation/#what-is-distributed-tracing → …/distributed-tracing/#what-is-distributed-tracing)

Examples:

  • /product/tracing/ → /concepts/key-terms/tracing/
  • /platforms/flutter/ → /platforms/dart/guides/flutter/
  • /platforms/javascript/apis/ → /platforms/javascript/configuration/apis/
  • /product/cli/ → /cli/
  • /integrations/launchdarkly/ → /integrations/feature-flag/launchdarkly/

Scope / deferred: markdown + <Link> only. Platform-relative <PlatformLink> links need per-platform handling and are a separate PR. The /data-management/* cluster now collapses to the generic /concepts/data-management/ parent (specific pages gone) and needs an SME decision. redirects.js is intentionally left untouched so external inbound links keep working.

Note: the crawler's "4,601 redirecting links" counts rendered instances; the authored source links are far fewer (~100 moved-page links + ~760 trailing-slash), which these follow-ups will cover.

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.

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

SLA

  • Teamwork makes the dream work, so please add a reviewer to your PRs.
  • Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it.
    Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

  • 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

Update internal markdown links that currently hit a 3xx redirect so they
point straight to the final destination, removing a redirect hop (saves
latency and preserves link equity). Destinations were resolved against
production (docs.sentry.io), since redirects.js is stale in places.

Covers 22 links across 19 files for high-confidence 1:1 moves, e.g.:
- /product/tracing/ -> /concepts/key-terms/tracing/
- /platforms/flutter/ -> /platforms/dart/guides/flutter/
- /platforms/javascript/apis/ -> /platforms/javascript/configuration/apis/
- /product/cli/ -> /cli/
- /integrations/launchdarkly/ -> /integrations/feature-flag/launchdarkly/

Scope: markdown and <Link> links only. Platform-relative <PlatformLink>
links and pages that now collapse to a generic parent (the
/data-management/* cluster) are deferred to follow-ups. redirects.js is
left untouched so external inbound links keep working.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Sep 25, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
sentry-docs Ready Ready Preview Sep 25, 2026 9:30pm UTC
1 Skipped Deployment
Project Deployment Actions Updated
develop-docs Ignored Ignored Sep 25, 2026 9:30pm UTC

Request Review

This branch was successfully deployed

1 active deployment
Preview – sentry-docs — 856c9d12 Deployed Sep 25, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Priority: Normal Docs review has no urgent deadline

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants