Restructure VS Code extension page (polyglot + 13.2 features)

[davidfowl]

Rewrites get-started/aspire-vscode-extension.mdx to be polyglot-first, narrative instead of table-heavy, and to cover the major 13.2 extension features that weren't documented.

Layout changes

Sections in the old order: Prerequisites → Install → Getting started → Running and debugging → Sidebar → Commands (table) → Languages (table) → Settings (table) → MCP → Feedback.

New order:

1. Intro + Prerequisites callout
2. What you get — hero gallery (CodeLens, sidebar, debug session) with a short bullet pitch
3. Install the extension
4. Getting started (with walkthrough tip)
5. Live editor integration (promoted) — CodeLens + gutter decorations
6. The Aspire sidebar (promoted) — aspire describe --follow, health icons, tooltips
7. Run, debug, and deploy — flat section, no H3 staircase
8. Language coverage
9. MCP server integration
10. Reference (Settings table + Commands in a <details>)
11. Feedback and issues

Content changes

Polyglot fixes

• launch.json examples use ${workspaceFolder} (auto-discovery) instead of MyAppHost.csproj.
• debuggers keys cover all six supported types: apphost, project, node, python, browser, azure-functions.
• New TypeScript AppHost paragraph and Azure Functions paragraph in language coverage.

13.2 features now documented

• CodeLens above resource definitions (state + Start/Stop/Restart/View Logs)
• Gutter decorations color-coded by resource state
• aspire.config.json AppHost discovery (works for both *.csproj and apphost.ts)
• CLI auto-detection at the default install location, plus code-insiders fallback
• Walkthrough with clickable terminal links
• Real-time sidebar updates via aspire describe --follow
• Health-aware icons + markdown tooltips
• Right-click context menus on resources and endpoint URLs
• Workspace vs Global mode toggle in the sidebar
• AppHost exit messages in the debug console
• Debuggable publish, deploy, and do flows
• Azure Functions debugging
• enableAspireDashboardAutoLaunch setting

De-table-ification

• 'Features at a glance' table removed entirely
• Commands table → 3 narrative paragraphs (now in collapsed <details>)
• Languages table → prose
• 'Customizing debugger settings' table → prose
• Settings table kept (the only one that earns its place)

Screenshots — TODO

Three new screenshots needed, dark + light = 6 PNG files in src/frontend/src/assets/get-started/:

Filename	Used in	Capture
code-extension-codelens{,-light}.png	Hero + Live editor section	AppHost source with CodeLens above resources (state + actions) and colored gutter dots
code-extension-sidebar{,-light}.png	Hero + Sidebar section	Aspire panel with resource tree, health icons, hover tooltip, Workspace/Global toggle
code-extension-debug{,-light}.png	Hero only	Run & Debug view with multiple sessions attached (AppHost + .NET + Node + browser)

Slots are marked with {/* TODO */} MDX comments naming the exact file. Page builds and passes lint + unit tests as-is.

Validation

• pnpm --dir ./src/frontend run lint ✅
• pnpm --dir ./src/frontend run test:unit:docs ✅

[Copilot]

Pull request overview

This PR updates the Aspire VS Code extension documentation to be more polyglot-focused and narrative-driven, and adjusts related CLI configuration guidance to reference the extension’s auto-registered JSON schema.

Changes:

• Rewrites the VS Code extension guide (get-started/aspire-vscode-extension.mdx) with a new structure, new screenshots, and updated launch/debug guidance.
• Simplifies VS Code JSON schema association guidance in the CLI configuration doc by pointing users to the VS Code extension.

Reviewed changes

Copilot reviewed 2 out of 8 changed files in this pull request and generated 6 comments.

File	Description
src/frontend/src/content/docs/get-started/aspire-vscode-extension.mdx	Major restructure/rewrite of the VS Code extension page, including new sections and updated launch.json examples.
src/frontend/src/content/docs/reference/cli/configuration.mdx	Replaces manual VS Code schema association instructions with a note about the VS Code extension auto-registering the schema.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.