diff --git a/src/frontend/src/content/docs/get-started/aspire-vscode-extension.mdx b/src/frontend/src/content/docs/get-started/aspire-vscode-extension.mdx
index 71b3e88fd..7b6f33f87 100644
--- a/src/frontend/src/content/docs/get-started/aspire-vscode-extension.mdx
+++ b/src/frontend/src/content/docs/get-started/aspire-vscode-extension.mdx
@@ -75,16 +75,7 @@ When an AppHost is running, the extension paints live state directly into your e
 
 **Editor title bar buttons** add **Run Aspire AppHost** and **Debug Aspire AppHost** actions next to the standard Run/Debug buttons whenever you have an AppHost file open.
 
-**Health-aware gutter decorations** provide an at-a-glance view of resource health and state without cluttering the editor with text using the following shapes and colors:
-
-| Icon | Meaning |
-|------|---------|
-| ✓ (green checkmark) | Running and healthy |
-| ⊙ (grey circle with check) | Completed — exited cleanly (exit code 0) |
-| ⚠ (yellow triangle with `!`) | Running but unhealthy (health checks failing) |
-| ✕ (red X) | Failed to start, exited with a non-zero exit code, or runtime unhealthy |
-| ⌛ (blue hourglass) | Starting, stopping, building, or waiting |
-| ○ (grey hollow circle) | Not yet started |
+**Health-aware gutter decorations** provide an at-a-glance view of resource health and state without cluttering the editor with text.
 
 <ThemeImage
   dark={sidebarTree}
@@ -100,6 +91,10 @@ Each resource shows its type, state, health summary, and exit code, plus a healt
 
 ## Run, debug, and deploy
 
+:::note[Debugging]
+The Aspire Dashboard is no longer opened by default when the AppHost starts, as most operations can be performed using the Aspire view inside VS Code. To launch the dashboard, use the **Open Dashboard** CodeLens, the **Aspire: Open Dashboard** command, or open it from the Aspire view.
+:::
+
 **Aspire: Configure launch.json file** adds a minimal launch configuration `.vscode/launch.json` that supports AppHosts written in any language. AppHosts are discovered automatically in the workspace. 
 
 <LearnMore>
@@ -160,10 +155,6 @@ Finally, you can specify `env` and `args` to set environment variables and comma
 For more information, see [Aspire publishing and deployment overview](/deployment/deploy-with-aspire/).
 </LearnMore>
 
-## Dashboard from VS Code
-
-By default, the dashboard opens automatically when the AppHost starts. You can also open it from the Aspire view if you closed the browser tab and want it back.
-
 ## Language coverage
 
 The extension detects each resource's language and attaches the right debugger: