docs: De-duplicate same-platform page titles - #19358
Merged
Merged
Conversation
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>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
1 Skipped Deployment
|
This was referenced Sep 11, 2026
coolguyzone
added a commit
that referenced
this pull request
Sep 21, 2026
## DESCRIBE YOUR PR
De-duplicates page titles that render as duplicate `<title>` tags on
**product, API, CLI, and integration pages**. Unlike platform docs,
these pages get no `| Sentry for {Platform}` suffix, so identical
frontmatter titles collide directly. Follow-up to #19301 / #19358,
scoped to the product bucket in #19351.
Each page gets a distinct, descriptive `title` (fixes `<title>` + H1)
plus a `sidebar_title` to keep the menu label short — the same pattern
as #19301.
- **"Set Up" getting-started cluster** → `Set Up {Product}` (Agents,
Logs, MCP Servers, Application Metrics, Cron Monitoring, Profiling,
Releases, User Feedback) — 8 pages that all rendered a bare "Set Up"
- **Webhook resource pages** → `Error Webhooks`, `Issue Webhooks`, `Seer
Webhooks`
- **Distinct pairs** → `API Authentication`, `Feature Flag
Integrations`, `Sentry CLI Logs`, `Docs Site Search`, `Web Vitals
Dashboard`
- **Sibling pairs qualified by surface** → Size Analysis / Snapshots
"Into CI"; Mobile / Web "Replay Performance Overhead"; Frontend / Mobile
"Session Health"
Resolves **12 of 14** collisions (22 pages).
## Deferred (needs a decision)
The **Agents Dashboards** and **MCP Dashboards** pairs are
near-duplicate *content* maintained in two IA locations (e.g.
`product/agents/dashboards` and `dashboards/sentry-dashboards/ai/agents`
share almost identical body text). Retitling them apart would mask a
duplicate-content issue; they need a canonical/redirect decision from
the Dashboards/AI team. Tracked 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
- [x] 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](https://github.com/orgs/getsentry/teams/docs)
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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 asidebar_titleto keep the menu label short — the same pattern used in #19301.<X> (Legacy SDK): Context, Integrations, Source Maps, Usage, Configuration (Go / PHP / Python / JavaScript)User Feedback Configuration(PHP, Elixir),Breadcrumbs Integration(JavaScript)Uploading Source Maps with Hermes/...with Expo(React Native)Source Context for Debug Files(Android, Apple)OpenTelemetry Support in 8.xCapturing Errors (Legacy)Resolves 16 of 17 same-platform collisions (17 pages). The remaining Java
OpenTelemetry Supportpair 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-DDwith the due date. You can update this information later by editing the PR description.SLA
Thanks in advance for your help!
PRE-MERGE CHECKLIST
Make sure you've checked the following before merging your changes: