Skip to content

Conversation

@codyde
Copy link
Contributor

@codyde codyde commented Nov 19, 2025

Standardizing navigation structured based off of JS PR to match updated structure

  1. Creating Feature / Configuration navigation ares
  2. Changing ordering to higher focus items higher on list
  3. Implementing callouts for new / beta features (metrics and logs)
CleanShot 2025-11-18 at 9  18 11@2x

codyde and others added 26 commits November 10, 2025 17:08
- Move apis.mdx from /common/ to /common/configuration/
- Move sampling.mdx from /common/configuration/ to /common/
- Add redirects for both old paths to maintain existing links

This reorganization improves the documentation structure by:
- Placing APIs documentation with other configuration topics
- Elevating sampling to a top-level concept (not just a config option)

All existing URLs will automatically redirect to the new locations.
- Move Logs to sidebar_order: 2 (add 'new' badge)
- Move Metrics to sidebar_order: 3 (add 'beta' badge)
- Move Session Replay to sidebar_order: 4
- Move Tracing to sidebar_order: 5 (add section separator)

This reorders the navigation to prioritize newer features (Logs, Metrics)
higher in the sidebar for better discoverability.
- Rename 'Configuration' to 'Advanced Configuration' for clarity
- Add explicit sidebar_title
- Move to sidebar_order: 100 to position at end of navigation

This helps differentiate basic setup from advanced configuration topics.
- Move feature selection buttons from Install to Configure section across all JS framework guides
- Add "Quick Start" link to platform sidebars for better navigation
- Change sidenav collapse breakpoint from 1024px to 1130px for better responsive behavior

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Standardizes Python SDK documentation navigation to match JavaScript structure:

**Sidebar Sections**
- Added 'Features' section with organized feature pages
- Added 'Configuration' section (renamed to 'Extended Configuration')
- Both sections now have proper headers and grouping

**Features Section** (sidebar_section: features)
Order: Capturing Errors → Logs → Tracing → Metrics → Profiling → Crons → User Feedback
- Renamed 'Usage' to 'Capturing Errors' (matching JS)
- Added 'new' tag to Logs
- Added 'beta' tag to Metrics
- Reordered all features for consistency

**Configuration Section** (sidebar_section: configuration)
Order: Sampling → Enriching Events → Extended Configuration → Integrations → Data Management → Security Policy Reporting → Migration → Troubleshooting
- Moved sampling.mdx from configuration/ to root (matching JS)
- Renamed Configuration index to 'Extended Configuration'
- Applied sidebar_section to all configuration files
- Applied sidebar_section to all related pages

**File Changes**
- 20 Python documentation files modified
- 1 file moved (sampling.mdx)
- 1 redirect added in redirects.js

Follows the pattern established in feat/js-docs-apis-sampling-restructure branch.
@vercel
Copy link

vercel bot commented Nov 19, 2025

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

Project Deployment Preview Comments Updated (UTC)
develop-docs Building Building Preview Comment Nov 19, 2025 5:17am
sentry-docs Building Building Preview Comment Nov 19, 2025 5:17am

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