Update nav for Java SDKs (#15726)

coolguyzone · Alex Krawiec · web-flow · commit 981c7c908ea6 · 2025-12-17T12:43:38.000-08:00
## DESCRIBE YOUR PR See changes on https://sentry-docs-git-feat-update-java-nav.sentry.dev/platforms/java/ and all Java SDKs Sidebar Sections Added 'Features' section with organized feature pages Added 'Configuration' section Both sections now have proper headers and grouping Features Section (sidebar_section: features) Order: Capturing Errors → Logs → Tracing → Profiling → Crons Renamed 'Usage' to 'Capturing Errors' Added 'new' tag to Logs Added 'beta' tag to Metrics Reordered all features for consistency Configuration Section (sidebar_section: configuration) Order: Enriching Events → Extended Configuration → Integrations → Data Management → Security Policy Reporting → Migration Guide → Troubleshooting Follows the pattern established in #15440 ## IS YOUR CHANGE URGENT? Help us prioritize incoming PRs by letting us know when the change needs to go live. - [ ] Urgent deadline (GA date, etc.):  - [ ] Other deadline:  - [ ] None: 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 added an urgent due date to it. 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) ## LEGAL BOILERPLATE  Look, I get it. The entity doing business as "Sentry" was incorporated in the State of Delaware in 2015 as Functional Software, Inc. and is gonna need some rights from me in order to utilize my contributions in this here PR. So here's the deal: I retain all rights, title and interest in and to my contributions, and by keeping this boilerplate intact I confirm that Sentry can use, modify, copy, and redistribute my contributions, under Sentry's choice of terms. ## EXTRA RESOURCES - [Sentry Docs contributor guide](https://docs.sentry.io/contributing/) --------- Co-authored-by: Alex Krawiec <alex.krawiec@R7J1Y747QQ.local>
diff --git a/docs/platforms/java/common/async/index.mdx b/docs/platforms/java/common/async/index.mdx
@@ -1,7 +1,8 @@
 ---
 title: Async Methods
 description: "Learn about how to propagate Scope to Spring async methods."
-sidebar_order: 6
+sidebar_order: 4.1
+sidebar_section: configuration
 supported:
   - java.spring
   - java.spring-boot
diff --git a/docs/platforms/java/common/configuration/index.mdx b/docs/platforms/java/common/configuration/index.mdx
@@ -1,7 +1,9 @@
 ---
-title: Configuration
+title: Extended Configuration
+sidebar_title: Extended Configuration
 description: "Learn more about how to configure the SDK. These options are set when the SDK is first initialized, passed to the init method as an object."
-sidebar_order: 5
+sidebar_order: 2
+sidebar_section: configuration
 ---
 
 ## Setting the DSN (Data Source Name)
diff --git a/docs/platforms/java/common/crons/index.mdx b/docs/platforms/java/common/crons/index.mdx
@@ -2,7 +2,8 @@
 title: Set Up Crons
 sidebar_title: Crons
 description: "Sentry Crons allows you to monitor the uptime and performance of any scheduled, recurring job in your application."
-sidebar_order: 5750
+sidebar_order: 5
+sidebar_section: features
 ---
 
 Once implemented, it'll allow you to get alerts and metrics to help you solve errors, detect timeouts, and prevent disruptions to your service.
diff --git a/docs/platforms/java/common/data-management/index.mdx b/docs/platforms/java/common/data-management/index.mdx
@@ -1,7 +1,8 @@
 ---
 title: Data Management
 description: Manage your events by pre-filtering, scrubbing sensitive information, and forwarding them to other systems.
-sidebar_order: 2500
+sidebar_order: 4
+sidebar_section: configuration
 ---
 
 <PageGrid />
diff --git a/docs/platforms/java/common/enriching-events/index.mdx b/docs/platforms/java/common/enriching-events/index.mdx
@@ -1,7 +1,8 @@
 ---
 title: Enriching Events
 description: Enrich events with additional context to make debugging simpler.
-sidebar_order: 2300
+sidebar_order: 1
+sidebar_section: configuration
 ---
 
 <PageGrid />
diff --git a/docs/platforms/java/common/feature-flags/index.mdx b/docs/platforms/java/common/feature-flags/index.mdx
@@ -1,7 +1,8 @@
 ---
 title: Set Up Feature Flags
 sidebar_title: Feature Flags
-sidebar_order: 7500
+sidebar_order: 7
+sidebar_section: features
 description: With Feature Flags, Sentry tracks feature flag evaluations in your application, keeps an audit log of feature flag changes, and reports any suspicious updates that may have caused an error.
 ---
 
diff --git a/docs/platforms/java/common/gradle/index.mdx b/docs/platforms/java/common/gradle/index.mdx
@@ -1,7 +1,8 @@
 ---
 title: Gradle
 description: Learn about using the Sentry Gradle Plugin.
-sidebar_order: 100
+sidebar_order: 8
+sidebar_section: features
 og_image: /og-images/platforms-java-common-gradle.png
 ---
 
diff --git a/docs/platforms/java/common/integrations/index.mdx b/docs/platforms/java/common/integrations/index.mdx
@@ -1,7 +1,8 @@
 ---
 title: Integrations
 description: "Learn more about how integrations extend the functionality of our SDK to cover common libraries and environments automatically."
-sidebar_order: 200
+sidebar_order: 3
+sidebar_section: configuration
 ---
 
 <PageGrid />
diff --git a/docs/platforms/java/common/legacy/index.mdx b/docs/platforms/java/common/legacy/index.mdx
@@ -1,6 +1,7 @@
 ---
 title: Legacy SDK (1.7)
-sidebar_order: 10000
+sidebar_order: 9
+sidebar_section: configuration
 ---
 
 This section covers the legacy Sentry SDK for Java (1.7.x), which is no longer under active development. We **strongly encourage** updating to [the updated Java SDK](/platforms/java/).
diff --git a/docs/platforms/java/common/logs/index.mdx b/docs/platforms/java/common/logs/index.mdx
@@ -2,7 +2,9 @@
 title: Set Up Logs
 sidebar_title: Logs
 description: "Structured logs allow you to send, view and query logs sent from your applications within Sentry."
-sidebar_order: 5755
+sidebar_order: 2
+sidebar_section: features
+new: true
 ---
 
 With Sentry Structured Logs, you can send text-based log information from your applications to Sentry. Once in Sentry, these logs can be viewed alongside relevant errors, searched by text-string, or searched using their individual attributes.
diff --git a/docs/platforms/java/common/maven/index.mdx b/docs/platforms/java/common/maven/index.mdx
@@ -1,7 +1,8 @@
 ---
 title: Maven
 description: "Learn about using the Sentry Maven Plugin."
-sidebar_order: 105
+sidebar_order: 9
+sidebar_section: features
 ---
 
 The [Sentry Maven Plugin](https://github.com/getsentry/sentry-maven-plugin) is an addition to the main Java SDK and offers
diff --git a/docs/platforms/java/common/migration/index.mdx b/docs/platforms/java/common/migration/index.mdx
@@ -1,6 +1,7 @@
 ---
 title: Migration Guides
-sidebar_order: 8000
+sidebar_order: 6
+sidebar_section: configuration
 description: "Learn about migrating to a newer version of the Java SDK."
 ---
 
diff --git a/docs/platforms/java/common/opentelemetry/index.mdx b/docs/platforms/java/common/opentelemetry/index.mdx
@@ -2,7 +2,8 @@
 title: OpenTelemetry Support
 sdk: sentry.java.opentelemetry-agent
 description: "Using OpenTelemetry with Sentry."
-sidebar_order: 160
+sidebar_order: 10
+sidebar_section: features
 ---
 
 [OpenTelemetry](https://opentelemetry.io/) enhances Sentry by providing support for more frameworks and libraries that:
diff --git a/docs/platforms/java/common/profiling/index.mdx b/docs/platforms/java/common/profiling/index.mdx
@@ -2,7 +2,8 @@
 title: Set Up Java Profiling
 sidebar_title: Profiling
 description: "Learn how to enable profiling in your app if it is not already set up."
-sidebar_order: 5000
+sidebar_order: 4
+sidebar_section: features
 supported:
   - java
 ---
diff --git a/docs/platforms/java/common/security-policy-reporting/index.mdx b/docs/platforms/java/common/security-policy-reporting/index.mdx
@@ -1,7 +1,8 @@
 ---
 title: Set Up Security Policy Reporting
 sidebar_title: Security Policy Reporting
-sidebar_order: 7500
+sidebar_order: 5
+sidebar_section: configuration
 description: "Learn how Sentry can help manage Content-Security-Policy violations and reports here."
 ---
 
diff --git a/docs/platforms/java/common/source-context/index.mdx b/docs/platforms/java/common/source-context/index.mdx
@@ -1,6 +1,7 @@
 ---
 title: Source Context
-sidebar_order: 110
+sidebar_order: 8
+sidebar_section: configuration
 description: Learn about showing your source code as part of stack traces.
 og_image: /og-images/platforms-java-common-source-context.png
 ---
diff --git a/docs/platforms/java/common/tracing/index.mdx b/docs/platforms/java/common/tracing/index.mdx
@@ -2,7 +2,8 @@
 title: Set Up Tracing
 sidebar_title: Tracing
 description: "Learn how to enable tracing in your app and discover valuable performance insights of your application."
-sidebar_order: 4000
+sidebar_order: 3
+sidebar_section: features
 supported:
   - java
   - java.spring-boot
diff --git a/docs/platforms/java/common/troubleshooting/index.mdx b/docs/platforms/java/common/troubleshooting/index.mdx
@@ -1,7 +1,8 @@
 ---
 title: Troubleshooting
 description: "Troubleshoot and resolve common issues with the Java SDK."
-sidebar_order: 9000
+sidebar_order: 7
+sidebar_section: configuration
 ---
 
 <PageGrid />
diff --git a/docs/platforms/java/common/usage/index.mdx b/docs/platforms/java/common/usage/index.mdx
@@ -1,7 +1,8 @@
 ---
-title: Usage
+title: Capturing Errors
 description: "Use the SDK to manually capture errors and other events."
-sidebar_order: 10
+sidebar_order: 1
+sidebar_section: features
 ---
 
 Sentry's SDK hooks into your runtime environment and automatically reports errors, uncaught exceptions, and unhandled rejections as well as other types of errors depending on the platform.
diff --git a/docs/platforms/java/common/user-feedback/index.mdx b/docs/platforms/java/common/user-feedback/index.mdx
@@ -2,7 +2,8 @@
 title: Set Up User Feedback
 sidebar_title: User Feedback
 description: "Learn more about collecting user feedback when an event occurs. Sentry pairs the feedback with the original event, giving you additional insight into issues."
-sidebar_order: 6000
+sidebar_order: 6
+sidebar_section: features
 ---
 
 The User Feedback feature allows you to collect user feedback from anywhere inside your application at any time, without needing an error event to occur first.
diff --git a/docs/platforms/java/guides/spring-boot/advanced-usage.mdx b/docs/platforms/java/guides/spring-boot/advanced-usage.mdx
@@ -1,6 +1,7 @@
 ---
 title: Advanced Usage
-sidebar_order: 6
+sidebar_order: 7
+sidebar_section: configuration
 description: "Learn about managing the release ID and customizing Spring Boot to your organization's needs."
 ---
 
diff --git a/docs/platforms/java/guides/spring-boot/logging-frameworks/logback.mdx b/docs/platforms/java/guides/spring-boot/logging-frameworks/logback.mdx
@@ -1,5 +1,7 @@
 ---
 title: Logback Integration
+sidebar_order: 9
+sidebar_section: configuration
 description: "Learn how to use Sentry's Logback integration with Spring Boot."
 ---
 
diff --git a/docs/platforms/java/guides/spring-boot/record-user.mdx b/docs/platforms/java/guides/spring-boot/record-user.mdx
@@ -1,6 +1,7 @@
 ---
 title: Record User Information
-sidebar_order: 7
+sidebar_order: 4.2
+sidebar_section: configuration
 description: "Learn about how you can record or customize the capture of user information."
 ---
 
diff --git a/docs/platforms/java/guides/spring-boot/webflux.mdx b/docs/platforms/java/guides/spring-boot/webflux.mdx
@@ -1,6 +1,7 @@
 ---
 title: WebFlux Integration
-sidebar_order: 6
+sidebar_order: 10
+sidebar_section: configuration
 description: "Learn more about using Spring WebFlux with Sentry."
 ---
 
diff --git a/docs/platforms/java/guides/spring/advanced-usage.mdx b/docs/platforms/java/guides/spring/advanced-usage.mdx
@@ -1,6 +1,7 @@
 ---
 title: Record User Information
-sidebar_order: 6
+sidebar_order: 4.2
+sidebar_section: configuration
 description: "Learn about how you can record or customize the capture of user information."
 ---
 
diff --git a/docs/platforms/java/usage.mdx b/docs/platforms/java/usage.mdx
@@ -1,6 +1,7 @@
 ---
-title: Usage
-sidebar_order: 10
+title: Capturing Errors
+sidebar_order: 1
+sidebar_section: features
 description: "Learn more about passing configuration options to a static Sentry#init method Sentry."
 ---
 
