Repository navigation
Consolidate 17.0 retired experimental diagnostics docs - #2176
Maddy Montaquila (maddymontaquila) merged 3 commits into
Conversation
Mark the experimental diagnostics that graduated in Aspire 17.0 as retired with a consistent "Retired in: 17.0" badge and note, update the diagnostics overview, add a consolidated What's new section, and remove stale suppressions across the docs. Supersedes #1846, #1847, #1851, #1852, #1853, #1854, #1856, #1857, #2127, #2167, #2168, #2169, #2170, and #2171. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
There was a problem hiding this comment.
🟡 Changes recommended
The migration caveat incorrectly advises users who publish or deploy to retain the obsolete API, even though DotnetProjectResource already supports automatic publishing.
1 open issue
What changed in this PR
Consolidates Aspire 17.0 diagnostic retirement documentation across the reference pages, integration guides, and release notes, replacing the separate per-diagnostic updates.
Changes:
- Marks retired diagnostics consistently while preserving historical guidance and distinguishing the remaining experimental scope of
ASPIRECOMPUTE002. - Documents
AddCSharpAppobsoletion and migration toAddDotnetProject. - Removes outdated experimental cautions and suppressions, and clarifies MCP endpoint behavior.
Paths below are relative to src/frontend/src/content/docs/.
| File | Description |
|---|---|
whats-new/aspire-17.mdx |
Summarizes API graduations and AddCSharpApp obsoletion. |
integrations/frameworks/javascript.mdx |
Removes retired JavaScript and Dockerfile-builder warnings. |
integrations/frameworks/dotnet/dotnet-host.mdx |
Links to AddCSharpApp migration guidance. |
integrations/dotnet/project-resources.mdx |
Adds the obsoletion notice to the API comparison. |
integrations/dotnet/csharp-file-based-apps.mdx |
Adds migration guidance and updates diagnostic suppressions. |
integrations/compute/kind/kind-host.mdx |
Removes the retired pipeline suppression. |
integrations/compute/docker.mdx |
Removes Dockerfile-builder experimental guidance. |
integrations/cloud/azure/role-assignments.mdx |
Removes the retired Azure diagnostic suppression. |
integrations/cloud/azure/configure-container-apps.mdx |
Updates naming API status while retaining deployment cautions. |
get-started/resource-mcp-servers.mdx |
Corrects PostgreSQL suppression and clarifies MCP endpoint selection. |
get-started/add-aspire-existing-app.mdx |
Updates AddCSharpApp warning and migration advice. |
fundamentals/environment-variables.mdx |
Documents stable connection-string naming metadata. |
diagnostics/overview.mdx |
Updates diagnostic statuses and adds ACANAMING002. |
diagnostics/aspireusersecrets001.mdx |
Marks user-secrets diagnostic retired in 17.0. |
diagnostics/aspireprobes001.mdx |
Marks HTTP-probe diagnostic retired in 17.0. |
diagnostics/aspirepipelines004.mdx |
Marks pipeline-output diagnostic retired in 17.0. |
diagnostics/aspirepipelines002.mdx |
Marks deployment-state diagnostic retired in 17.0. |
diagnostics/aspirepipelines001.mdx |
Marks core-pipeline diagnostic retired in 17.0. |
diagnostics/aspiremcp001.mdx |
Marks WithMcpServer diagnostic retired in 17.0. |
diagnostics/aspirejavascript001.mdx |
Marks JavaScript diagnostic retired in 17.0. |
diagnostics/aspirefilesystem001.mdx |
Marks filesystem diagnostic retired in 17.0. |
diagnostics/aspiredockerfilebuilder001.mdx |
Marks Dockerfile-builder diagnostic retired in 17.0. |
diagnostics/aspirecsharpapps001.mdx |
Explains retirement and replacement by CS0618. |
diagnostics/aspirecompute002.mdx |
Narrows experimental scope to persistent volumes. |
diagnostics/aspirecommand001.mdx |
Marks command-validation diagnostic retired in 17.0. |
diagnostics/aspireazure001.mdx |
Marks Azure publishing diagnostic retired in 17.0. |
diagnostics/aspireacanaming002.mdx |
Marks unique-naming diagnostic retired in 17.0. |
diagnostics/aspireacanaming001.mdx |
Marks compact-naming diagnostic retired in 17.0. |
deployment/pipelines.mdx |
Removes retired pipeline suppressions. |
deployment/javascript-apps.mdx |
Removes retired JavaScript and pipeline cautions and suppressions. |
deployment/docker-compose.mdx |
Removes Dockerfile-builder cautions and suppressions. |
deployment/custom-deployments.mdx |
Distinguishes stable pipelines from experimental image-building APIs. |
app-host/withdockerfile.mdx |
Removes Dockerfile-builder cautions and suppressions. |
Review effort: Balanced
Frontend HTML artifact readyThe latest frontend build uploaded the This comment updates automatically when a new frontend build artifact is uploaded. |
Move AddCSharpApp -> AddDotnetProject migration guidance out of this PR into a separate ProjectResource v2 guidance overhaul. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
|
This is informational artifact-notification content and does not request a code change. No repository change is needed; the build artifact is available through the provided link. |
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
71fe831
into
release/17.0

Summary
Consolidates the retired experimental diagnostic documentation for Aspire 17.0, superseding the individual PRs against
release/17.0.ASPIREDENO001andASPIRECONNECTIONSTRINGS001, which don't have dedicated pages.ASPIRECOMPUTE002was only partially graduated: endpoint-mapping contracts are stable, while persistent-volume APIs remain experimental.ASPIREPIPELINES003.ASPIRECSHARPAPPS001was retired whenAddCSharpAppbecame obsolete. The broader migration and ProjectResource v2 guidance is separate in docs: Migrate to AddDotnetProject/DotnetProjectResource and remove Aspire.AppHost.Sdk #2180.The retired diagnostic list was checked against
[Experimental("…")]usages inmicrosoft/aspirebetweenv13.6.5andrelease/17.0.Supersedes #1846, #1847, #1851, #1852, #1853, #1854, #1856, #1857, #2127, #2167, #2168, #2169, #2170, #2171.
Third-party links and affiliations
None
Validation
git diff --check origin/release/17.0 -- src/frontend/src/content/docs— passed.