From 68ccf0e9902cb44ab92cdac7c74de8a429aa7c57 Mon Sep 17 00:00:00 2001 From: Antonis Lilis Date: Wed, 3 Jun 2026 11:49:48 +0200 Subject: [PATCH 1/3] docs(flutter): Move debug symbols from features to configuration sidebar Aligns Flutter/Dart debug symbols docs with other mobile SDKs (React Native, Apple) which categorize debug symbol uploads under configuration, not features. This prevents AI-powered tools like sentry init from treating debug symbols as an optional selectable feature. Co-Authored-By: Claude Opus 4.6 --- docs/platforms/dart/common/debug-symbols/index.mdx | 2 +- docs/platforms/dart/guides/flutter/debug-symbols/index.mdx | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/platforms/dart/common/debug-symbols/index.mdx b/docs/platforms/dart/common/debug-symbols/index.mdx index 28a2f005d9e5a..2fbea8843c9c1 100644 --- a/docs/platforms/dart/common/debug-symbols/index.mdx +++ b/docs/platforms/dart/common/debug-symbols/index.mdx @@ -1,7 +1,7 @@ --- title: Debug Symbols sidebar_order: 3 -sidebar_section: features +sidebar_section: configuration --- Sentry currently does not support symbolication or debug symbol uploads for pure Dart applications. diff --git a/docs/platforms/dart/guides/flutter/debug-symbols/index.mdx b/docs/platforms/dart/guides/flutter/debug-symbols/index.mdx index a5c47aadb4af8..dbee423cd0264 100644 --- a/docs/platforms/dart/guides/flutter/debug-symbols/index.mdx +++ b/docs/platforms/dart/guides/flutter/debug-symbols/index.mdx @@ -1,8 +1,8 @@ --- title: Debug Symbols -description: "Learn about uploading debug symbols to enable symbolication of stack traces in your Flutter applications." +description: "Learn how to upload debug symbols so Sentry can show readable stack traces when using Flutter's split-debug-info or obfuscate flags. This is a configuration step, not an optional feature." sidebar_order: 3 -sidebar_section: features +sidebar_section: configuration --- Debug symbols are essential for understanding stack traces in your Flutter application when errors occur. Without debug symbols, stack traces from minified or obfuscated code can be difficult or impossible to interpret. From 730441e808ca03f386d29883c07c45a175360ae8 Mon Sep 17 00:00:00 2001 From: Antonis Lilis Date: Wed, 3 Jun 2026 11:51:09 +0200 Subject: [PATCH 2/3] docs(flutter): Revert description change, keep only sidebar_section fix Co-Authored-By: Claude Opus 4.6 --- docs/platforms/dart/guides/flutter/debug-symbols/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/platforms/dart/guides/flutter/debug-symbols/index.mdx b/docs/platforms/dart/guides/flutter/debug-symbols/index.mdx index dbee423cd0264..e4bce5f293b4a 100644 --- a/docs/platforms/dart/guides/flutter/debug-symbols/index.mdx +++ b/docs/platforms/dart/guides/flutter/debug-symbols/index.mdx @@ -1,6 +1,6 @@ --- title: Debug Symbols -description: "Learn how to upload debug symbols so Sentry can show readable stack traces when using Flutter's split-debug-info or obfuscate flags. This is a configuration step, not an optional feature." +description: "Learn about uploading debug symbols to enable symbolication of stack traces in your Flutter applications." sidebar_order: 3 sidebar_section: configuration --- From 12876fe3a6f5d8476481e38586db1d8aefeaee38 Mon Sep 17 00:00:00 2001 From: Antonis Lilis Date: Wed, 3 Jun 2026 12:17:50 +0200 Subject: [PATCH 3/3] docs(flutter): Bump debug symbols sidebar_order to 50 Places it below Basic Configuration (5) in the configuration section, matching Apple's dsym page ordering. Co-Authored-By: Claude Opus 4.6 --- docs/platforms/dart/common/debug-symbols/index.mdx | 2 +- docs/platforms/dart/guides/flutter/debug-symbols/index.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/platforms/dart/common/debug-symbols/index.mdx b/docs/platforms/dart/common/debug-symbols/index.mdx index 2fbea8843c9c1..e1d73407d0573 100644 --- a/docs/platforms/dart/common/debug-symbols/index.mdx +++ b/docs/platforms/dart/common/debug-symbols/index.mdx @@ -1,6 +1,6 @@ --- title: Debug Symbols -sidebar_order: 3 +sidebar_order: 50 sidebar_section: configuration --- diff --git a/docs/platforms/dart/guides/flutter/debug-symbols/index.mdx b/docs/platforms/dart/guides/flutter/debug-symbols/index.mdx index e4bce5f293b4a..17208cd7a045b 100644 --- a/docs/platforms/dart/guides/flutter/debug-symbols/index.mdx +++ b/docs/platforms/dart/guides/flutter/debug-symbols/index.mdx @@ -1,7 +1,7 @@ --- title: Debug Symbols description: "Learn about uploading debug symbols to enable symbolication of stack traces in your Flutter applications." -sidebar_order: 3 +sidebar_order: 50 sidebar_section: configuration ---