Repository navigation
Document VS Code resource attach and editor-assistance language model tools (Aspire 17.0) - #2192
Conversation
|
Copilot resolve the merge conflicts in this pull request |
|
Copilot retarget this PR to release/17.0 branch NOW |
Resolved in a615f44 by merging the latest |
I couldn’t change the base: this session has no PR-editing tool, and the browser is signed out of GitHub. #2192 still targets |
… tools Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
277f51d to
6c210c1
Compare
There was a problem hiding this comment.
🔵 Needs a closer look
The restricted review environment prevented required documentation-rendering and interactive VS Code checks, leaving debugger behavior and Linux/macOS permission guidance dependent on human validation.
No open issues 🎉
What changed in this PR
Documents Aspire 17.0’s VS Code debugger attach workflow and editor-assistance language model tools, connecting the extension guide with Go debugging, Hot Reload, CLI reference, and release notes.
Changes:
- Adds attach prerequisites, steps, limitations, and platform permission guidance.
- Documents tool inputs, outcomes, minimum versions, and Hot Reload applicability.
- Adds Go build-flag examples, project launch metadata, and release-note cross-links.
| File | Description |
|---|---|
src/frontend/src/content/docs/whats-new/aspire-17.mdx |
Summarizes debugger attach and editor-assistance tools. |
src/frontend/src/content/docs/reference/cli/commands/aspire-describe.mdx |
Documents project launch metadata and process ID behavior. |
src/frontend/src/content/docs/integrations/frameworks/go/go-host.mdx |
Adds attach-later guidance and debug-friendly build flags. |
src/frontend/src/content/docs/get-started/aspire-vscode-extension.mdx |
Adds the attach workflow and per-tool reference. |
src/frontend/src/content/docs/app-host/hot-reload-and-watch.mdx |
Explains Hot Reload status applicability and fallback actions. |
Review effort: Balanced
Frontend HTML artifact readyThe latest frontend build uploaded the This comment updates automatically when a new frontend build artifact is uploaded. |
Important
Retarget this PR to
release/17.0before merging. Every page edited here exists only onrelease/17.0, so this branch merges that branch in. Againstmain, the diff also shows unrelated 17.0 content.Aspire 17.0 adds two VS Code extension features: Attach debugger for running .NET and Go resources (microsoft/aspire#18602, extension v1.25.0) and six editor-assistance language model tools (microsoft/aspire#19414, v1.24.0). aspire.dev listed the tool names but didn't explain how to use either feature. The facts below come from the extension source and READMEs on microsoft/aspire
release/17.0.get-started/aspire-vscode-extension.mdxms-dotnettools.csharpfor .NET;golang.go, Delve and 17.0 Go hosting for Go.dotnet run,dotnet watchorgo runlauncher. Never starts or restarts a resource. Reports when a debugger is already attached.dotnet watchwith arguments after--,WithDelveServer, and no detach tool ([VS Code] Add an agent tool to detach a resource debugger without stopping the application aspire#22154).ptrace_scopeand the macOS_developergroup.knownAppHosts.<details>block per 17.0 tool with its inputs and outcomes. It also covers Hot Reload semantics, the latest launch failure kept per AppHost for 30 minutes, and dashboard and Output behavior.integrations/frameworks/go/go-host.mdxaspire startboth use DCP-managedgo run.WithDelveServerare mutually exclusive.-s -wflags in the existing "Configure build options" example strip the information source breakpoints need. That example is unchanged.Other pages
app-host/hot-reload-and-watch.mdx: a paragraph on whataspire_hot_reload_statusreports:reference/cli/commands/aspire-describe.mdx: the newproject.launchCommand(run,watch,ide,direct, ornull),project.configurationandproject.targetFrameworkproperties.whats-new/aspire-17.mdx: a new "🧰 Visual Studio Code extension" section and an intro bullet.Review notes
ptrace_scopenote covers Go/Delve only. I couldn't confirm the .NET behavior, so the note doesn't mention it.