Document launch profiles for dotnet run - #55785
Conversation
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
|
CC. @baronfel noticed we were missing docs around this and everything essentially just linked to ASP.NET instead. So this covers what |
There was a problem hiding this comment.
Copilot review overview
🟢 Approval recommended
Review tier: Lite
Findings: None
What changed in this PR
This PR documents the launchSettings.json contract that the .NET SDK and dotnet run support, including how profiles are discovered and selected, which profile types and properties the CLI recognizes, how environment variables and argument precedence work, and where Visual Studio/debugger behavior differs from the CLI contract.
Changes:
- Added a new Launch profiles section to
dotnet rundocumentation that defines profile structure, selection behavior, supportedcommandNamevalues, supported properties, and Visual Studio comparisons. - Updated
--launch-profileand environment variable precedence documentation to point back to the new consolidated reference. - Linked file-based app launch profile docs to the general
dotnet runlaunch profile reference, and updated related cross-references.
| File | Description |
|---|---|
| docs/core/tools/dotnet-run.md | Adds comprehensive dotnet run launch profile reference and updates CLI option/env-var documentation to align with it. |
| docs/core/tools/dotnet-environment-variables.md | Updates DOTNET_LAUNCH_PROFILE section to deep-link to the new launch profiles reference. |
| docs/core/sdk/file-based-apps.md | Links file-based app launch profiles section back to the general dotnet run launch profiles reference. |
💡 Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.
baronfel
left a comment
There was a problem hiding this comment.
Absolutely lovely - thank you for taking the time.
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Documents the general
launchSettings.jsoncontract supported by the .NET SDK anddotnet run, including profile discovery and selection, supported profile types and properties, precedence, path and variable expansion, and runtime configuration links.Clarifies where Visual Studio, debugger, desktop-project, and workload-specific behavior extends or differs from the CLI contract. Links file-based app launch profiles and
DOTNET_LAUNCH_PROFILEback to the general reference.Note
This PR was created with the assistance of GitHub Copilot.
Internal previews
Build report