Add documentation for ASPIREPIPELINES001, ASPIREPIPELINES002, and ASPIREPIPELINES003 diagnostics

[Copilot]

Implements documentation for three experimental diagnostic codes introduced in dotnet/aspire#12416, which reorganized pipeline-related experimental APIs from the generic ASPIREPUBLISHERS001 code into sequential ASPIREPIPELINES codes.

New diagnostic pages

• ASPIREPIPELINES001: Pipeline infrastructure APIs (IPipelineActivityReporter, IReportingStep, CompletionState, PublishingContext)
• ASPIREPIPELINES002: Deployment state management APIs (IDeploymentStateManager, Deploy/ClearCache/Step options, DeployingCallbackAnnotation)
• ASPIREPIPELINES003: Container image build APIs (IResourceContainerImageBuilder, ContainerBuildOptions, ContainerTargetPlatform, Docker/Podman runtimes)

All three diagnostics:

• Version introduced: 13.0 (based on milestone in Fix up Experimental diagnostic codes in pipelines area aspire#12415)
• Type: Experimental error
• Message: "APIs are for evaluation purposes only and are subject to change or removal in future updates"

Changes

• Created aspirepipelines001.md, aspirepipelines002.md, aspirepipelines003.md following established diagnostic documentation template
• Updated overview.md diagnostics table with three new entries in alphabetical order
• Added ai-usage: ai-generated metadata per repository guidelines
• Added all three diagnostics to the TOC (docs/toc.yml) under both the "Errors" section and "Experimental" category with descriptive names

Original prompt

Based on the new diagnostics introduced in dotnet/aspire#12416 create documentation pages for each diagnostic based on the template in https://github.com/dotnet/docs-aspire/issues/new?template=06-diagnostic-addition.yml.

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

---

Internal previews

📄 File	🔗 Preview link
docs/diagnostics/aspirepipelines001.md	docs/diagnostics/aspirepipelines001
docs/diagnostics/aspirepipelines002.md	docs/diagnostics/aspirepipelines002
docs/diagnostics/aspirepipelines003.md	docs/diagnostics/aspirepipelines003
docs/diagnostics/overview.md	docs/diagnostics/overview
docs/toc.yml	docs/toc

[eerhardt]

Why is this 9.2?

[Copilot]

Fixed in commit 5358f9e. Updated to version 13.0 based on the milestone in dotnet/aspire#12415. Also updated diagnostic codes to use ASPIREPIPELINES002 instead of ASPIREDEPLOYMENT001 to match the latest changes in the PR.

[captainsafia]

Never peer into the soul of an LLM and ask why.... 😆

[eerhardt]

Same question

[Copilot]

Fixed in commit 5358f9e. Updated to version 13.0 based on the milestone in dotnet/aspire#12415. Also updated diagnostic codes to use ASPIREPIPELINES003 instead of ASPIREIMGBUILD001 to match the latest changes in the PR.

[captainsafia]

@copilot The diagnostic codes referenced here are out of date with those proposed in the PR. Update the PR to reference the latest changes in https://github.com/dotnet/aspire/pull/12416.diff.

[Copilot]

@copilot The diagnostic codes referenced here are out of date with those proposed in the PR. Update the PR to reference the latest changes in https://github.com/dotnet/aspire/pull/12416.diff.

Fixed in commit 5358f9e. Updated diagnostic codes to match the latest PR which uses sequential ASPIREPIPELINES001-003 naming instead of the mixed ASPIREPIPELINES001/ASPIREDEPLOYMENT001/ASPIREIMGBUILD001 naming. Also updated version to 13.0 based on the milestone.

[IEvangelist]

Hey @copilot please also add these new articles to the diagnostics TOC.

[Copilot]

Hey @copilot please also add these new articles to the diagnostics TOC.

Added in commit 706911d. The three new diagnostics are now included in the TOC under both the "Errors" section (alphabetically) and the "Experimental" category with descriptive names.