Skip to content

feat: Flatten Explore section into Product sidebar with section headers#17819

Open
sfanahata wants to merge 5 commits into
masterfrom
pr/1-flatten-explore
Open

feat: Flatten Explore section into Product sidebar with section headers#17819
sfanahata wants to merge 5 commits into
masterfrom
pr/1-flatten-explore

Conversation

@sfanahata

@sfanahata sfanahata commented May 20, 2026

Copy link
Copy Markdown
Contributor

Summary

Flattens the product/explore/ section, moving its 6 child directories up to product/ so features like Logs, Traces, and Session Replay are visible at L2 instead of buried at L3.

Adds sidebar section headers (Detect, Debug, Measure, Automate, Platform) to the Product sidebar using the existing sidebar_section mechanism.

Rewrites the Product index page and Getting Started section to reflect Sentry's current product positioning and feature set. Deletes the orphaned /product/onboarding/ section. Hides dated tutorials (distributed-tracing, integrate-frontend, integrate-backend) from sidebar while keeping URLs functional. Fixes broken links, dead references, and stale content across sentry-basics sub-pages.

Changes

Code changes (3 files):

  • Extended sidebar_section in dynamicNav.tsx, frontmatter.ts, types.ts to support 5 new section values: detect, debug, measure, automate, platform

File moves (6 directories, ~89 files):

  • product/explore/trace-explorer/product/trace-explorer/
  • product/explore/logs/product/logs/
  • product/explore/session-replay/product/session-replay/
  • product/explore/profiling/product/profiling/
  • product/explore/metrics/product/metrics/
  • product/explore/discover-queries/product/discover-queries/

Content updates:

  • Rewrote product/index.mdx — organized around Detect/Debug/Measure/Automate sections, added missing features (Logs, Seer, Snapshots, Size Analysis, AI Agents Monitoring), removed dated sections
  • Rewrote product/sentry-basics/index.mdx — 4-step getting started hub (Connect Source Code → Set Up Alerts → Turn On Features → Explore Data), links to Guides, Cookbook, Sandbox
  • Rewrote product/sentry-basics/performance-monitoring.mdx — removed duplicated paragraphs, stale Early Adopter reference, added Connected Context section (Logs, Replay, Profiling, Seer)
  • Fixed broken links in tutorial sub-pages (dead /guides/integrate-* paths, dead /product/sentry-basics/enrich-data/ link)
  • Fixed typo and code syntax error in user-feedback-basics.mdx
  • Fixed broken blog.sentry.io URLs in session-replay performance-overhead pages

Deleted content:

  • Removed product/onboarding/ (3 pages, orphaned — only 1 self-referencing inbound link, not linked from homepage or SDK pages)
  • Hidden 3 dated tutorials from sidebar: distributed-tracing/, integrate-frontend/, integrate-backend/ (URLs still work for featureInfo.tsx references)

Frontmatter updates (~25 files):

  • Every product/*/index.mdx gets sidebar_section and updated sidebar_order

Link updates (~200 files):

  • All internal references to /product/explore/* updated to /product/*
  • Removed 4 self-referencing redirect loops in middleware.ts
  • Fixed broken blog.sentry.io URLs (date-prefixed → dateless format)

Redirects:

  • Added redirects from old /product/explore/* paths to new locations
  • Added redirects from /product/onboarding/* to /product/sentry-basics/
  • Updated existing redirect destinations in redirects.js and middleware.ts

Section assignments

Section Pages
Detect Issues, User Feedback, Snapshots, Size Analysis
Debug Traces and Spans, Logs, Session Replay, Profiling, Application Metrics, Log and Trace Drains, Discover
Measure Dashboards, Releases, Stats
Automate AI in Sentry, Monitors and Alerts
Platform Build Distribution, Projects, Sentry Notifications, Sentry Toolbar, Relay, Partnership Platform

@vercel

vercel Bot commented May 20, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
sentry-docs Building Building Preview, Comment Jun 29, 2026 8:52pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Preview Jun 29, 2026 8:52pm

Request Review

Comment thread middleware.ts Outdated
Move 6 child directories out of product/explore/ up to product/:
- trace-explorer (Traces and Spans)
- logs (Logs)
- session-replay (Session Replay)
- profiling (Profiling)
- metrics (Application Metrics)
- discover-queries (Discover)

Add sidebar_section support for Product pages with 5 new section
headers: Debug, Investigate, Observe, AI in Sentry, Advanced.

Update all ~200 internal links from /product/explore/* to /product/*.
Add redirects from old /product/explore/* paths to new locations.
Update redirect destinations in redirects.js and middleware.ts.

Section assignments:
- Debug: Issues, Monitors and Alerts
- Investigate: Traces and Spans, Logs, Session Replay, Profiling
- Observe: Dashboards, Metrics, Releases, Stats, Size Analysis
- AI in Sentry: AI in Sentry
- Advanced: Discover, User Feedback, Drains, Projects, Relay,
  Toolbar, Notifications, Partnership Platform, Build Distribution,
  Snapshots, Codecov
@sfanahata sfanahata force-pushed the pr/1-flatten-explore branch from 9e55eb4 to 46852ac Compare June 25, 2026 18:48
@sfanahata sfanahata marked this pull request as ready for review June 26, 2026 21:21
Comment thread docs/product/index.mdx Outdated
Comment thread redirects.js
Comment on lines +1684 to 1686
source: '/product/explore',
destination: '/product/trace-explorer/',
},

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.

Bug: The redirect for /product/explore lacks a trailing slash, causing 404s for users visiting the canonical URL.
Severity: MEDIUM

Suggested Fix

Update the source property for the redirect in redirects.js to include a trailing slash. Change '/product/explore' to '/product/explore/' to ensure it correctly matches the canonical URL and redirects users as intended.

Prompt for AI Agent
Review the code at the location below. A potential bug has been identified by an AI
agent. Verify if this is a real issue. If it is, propose a fix; if not, explain why it's
not valid.

Location: redirects.js#L1684-L1686

Potential issue: The project is configured with `trailingSlash: true` in
`next.config.ts`, which establishes URLs with a trailing slash as the canonical version.
A new redirect has been added for the removed `/product/explore` page, but its source is
`'/product/explore'` without a trailing slash. Consequently, this redirect will not
match requests for the old canonical URL `/product/explore/`, leading to a 404 error for
users with bookmarks or direct links to that URL.

Did we get this right? 👍 / 👎 to inform future reviews.

@antonis antonis 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.

The RN side LGTM 🙏

@codeowner-assignment codeowner-assignment Bot requested review from a team June 29, 2026 19:46

@cursor cursor Bot 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.

Cursor Bugbot has reviewed your changes and found 2 potential issues.

Fix All in Cursor

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

Want reviews to match your repository better? Bugbot Learning can learn team-specific rules from PR activity. A team admin can enable Learning in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit c5e6971. Configure here.

title: Discover
sidebar_order: 90
sidebar_order: 260
sidebar_section: debug

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.

Discover placed in Debug section

Medium Severity

This commit assigns Discover sidebar_section: debug, so it appears under the sidebar’s Debug group with traces and logs. The PR’s section plan lists Discover under Advanced, and the updated Product walkthrough index does not include Discover under Debug.

Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit c5e6971. Configure here.

Comment thread docs/product/build-distribution/index.mdx Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants