Skip to content

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

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

feat: Flatten Explore section into Product sidebar with section headers#17819
sfanahata wants to merge 9 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)
develop-docs Ready Ready Preview, Comment Jun 30, 2026 9:41pm
sentry-docs Ready Ready Preview, Comment Jun 30, 2026 9:41pm

Request Review

Comment thread middleware.ts Outdated
@sfanahata sfanahata force-pushed the pr/1-flatten-explore branch from cf44f3d to 391cbd9 Compare May 20, 2026 17:42
@sfanahata sfanahata force-pushed the pr/1-flatten-explore branch from b77919b to b6741a8 Compare May 20, 2026 19:12
@sfanahata sfanahata force-pushed the pr/1-flatten-explore branch from c8ae995 to eaed914 Compare May 20, 2026 20:18
@sfanahata sfanahata force-pushed the pr/1-flatten-explore branch from ad0c744 to e6d2c0a Compare May 20, 2026 20:26
@sfanahata sfanahata force-pushed the pr/1-flatten-explore branch from adc9776 to 19083c7 Compare May 20, 2026 20:38
@sfanahata sfanahata force-pushed the pr/1-flatten-explore branch from dc412c0 to 90b3063 Compare May 27, 2026 19:44
@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

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

Comment thread docs/product/discover-queries/index.mdx
Comment thread docs/product/build-distribution/index.mdx Outdated
Shannon Anahata and others added 7 commits June 30, 2026 14:06
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 b490719 to 2ad6b38 Compare June 30, 2026 21:06
Comment thread docs/product/sentry-basics/performance-monitoring.mdx
Comment thread redirects.js
- Remove trailing slash from #span-metrics/ anchor in performance-monitoring.mdx
- Add trailing-slash variants for /product/explore/traces/ and
  /product/explore/new-trace-explorer/ redirects
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