Skip to content

docs: De-duplicate same-platform page titles - #19358

Open
coolguyzone wants to merge 1 commit into
masterfrom
coolguyzone/chore/platform-name-dupes
Open

docs: De-duplicate same-platform page titles#19358
coolguyzone wants to merge 1 commit into
masterfrom
coolguyzone/chore/platform-name-dupes

Conversation

@coolguyzone

Copy link
Copy Markdown
Contributor

DESCRIBE YOUR PR

De-duplicates page titles that collided in the rendered <title> tag within a single platform (where the | Sentry for {Platform} suffix can't disambiguate them). Follow-up to #19301, scoped to the same-platform bucket tracked in #19351.

Each page gets a distinct, descriptive title (fixes the <title> tag + H1) plus a sidebar_title to keep the menu label short — the same pattern used in #19301.

  • Legacy SDK pages<X> (Legacy SDK): Context, Integrations, Source Maps, Usage, Configuration (Go / PHP / Python / JavaScript)
  • Feature-section pagesUser Feedback Configuration (PHP, Elixir), Breadcrumbs Integration (JavaScript)
  • Source-map upload pagesUploading Source Maps with Hermes / ...with Expo (React Native)
  • Debug-file source contextSource Context for Debug Files (Android, Apple)
  • JS OpenTelemetry migration pageOpenTelemetry Support in 8.x
  • Legacy Java usage pageCapturing Errors (Legacy)

Resolves 16 of 17 same-platform collisions (17 pages). The remaining Java OpenTelemetry Support pair is a moved-page stub that should become a redirect rather than be retitled — left for the redirect follow-up in #19351.

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.
Select exactly one option. For deadlines, replace YYYY-MM-DD with the due date. You can update this information later by editing the PR description.

  • Urgent deadline (GA date, etc.): YYYY-MM-DD
  • Other deadline: YYYY-MM-DD
  • No deadline: 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 supplied a deadline.

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

Give distinct, descriptive titles to pages that rendered an identical
<title> tag within a single platform, using sidebar_title to keep the
menu labels short (per the pattern in #19301):

- Legacy SDK pages: "<X> (Legacy SDK)" (Context, Integrations, Source
  Maps, Usage, Configuration across Go/PHP/Python/JavaScript)
- Feature-section pages: "User Feedback Configuration" (PHP, Elixir),
  "Breadcrumbs Integration" (JavaScript)
- Source-map upload pages: "Uploading Source Maps with Hermes/Expo"
  (React Native)
- Debug-file source context: "Source Context for Debug Files"
  (Android, Apple)
- JS OpenTelemetry migration page: "OpenTelemetry Support in 8.x"
- Legacy Java usage page: "Capturing Errors (Legacy)"

Resolves 16 of the 17 same-platform title collisions. The remaining
Java "OpenTelemetry Support" pair is a moved-page stub that should
become a redirect (tracked separately in #19351).

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

vercel Bot commented Sep 10, 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 10, 2026 8:58pm UTC
1 Skipped Deployment
Project Deployment Actions Updated
develop-docs Ignored Ignored Sep 10, 2026 8:58pm UTC

Request Review

@sfanahata sfanahata left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks much better!

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