Add documentation for ASPIREPIPELINES001, ASPIREPIPELINES002, and ASPIREPIPELINES003 diagnostics #5359

Copilot · 2025-10-27T23:25:54Z

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

Co-authored-by: captainsafia <[email protected]>

eerhardt · 2025-10-28T00:05:50Z

docs/diagnostics/aspiredeployment001.md

+
+# Compiler Error ASPIREDEPLOYMENT001
+
+**Version introduced:** 9.2


Why is this 9.2?

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.

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

eerhardt · 2025-10-28T00:05:58Z

docs/diagnostics/aspireimgbuild001.md

+
+# Compiler Error ASPIREIMGBUILD001
+
+**Version introduced:** 9.2


Same question

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 · 2025-10-28T00:15:02Z

@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.

…d naming scheme Co-authored-by: captainsafia <[email protected]>

Copilot · 2025-10-28T00:21:51Z

@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 · 2025-10-28T18:23:33Z

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

Co-authored-by: IEvangelist <[email protected]>

Copilot · 2025-10-28T18:26:48Z

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.

@JamesNK

* Document ClaimActions configuration for dashboard OpenID Connect authentication (#5192) * Initial plan * Document ClaimActions configuration for dashboard OIDC authentication Co-authored-by: JamesNK <[email protected]> * Apply suggestion from @JamesNK * Apply suggestion from @JamesNK * Apply suggestion from @JamesNK * Update configuration.md --------- Co-authored-by: copilot-swe-agent[bot] <[email protected]> Co-authored-by: JamesNK <[email protected]> Co-authored-by: James Newton-King <[email protected]> * Document breaking change: DefaultAzureCredential defaults to ManagedIdentityCredential on ACA and App Service (#5303) * Initial plan * Add breaking change documentation for DefaultAzureCredential in 13.0 Co-authored-by: IEvangelist <[email protected]> * Fix markdown linting error - add blank line before list Co-authored-by: IEvangelist <[email protected]> * Update docs/compatibility/13.0/defaultazurecredential-managedidentity-default.md --------- Co-authored-by: copilot-swe-agent[bot] <[email protected]> Co-authored-by: IEvangelist <[email protected]> Co-authored-by: David Pine <[email protected]> * Update Azure AI Foundry and GitHub Models documentation to use strongly-typed model constants (#5302) * Initial plan * Update documentation to use AIFoundryModel and GitHubModel constants Co-authored-by: IEvangelist <[email protected]> * Update compatibility matrix to use GitHubModel constant Co-authored-by: IEvangelist <[email protected]> * Apply suggestions from code review --------- Co-authored-by: copilot-swe-agent[bot] <[email protected]> Co-authored-by: IEvangelist <[email protected]> Co-authored-by: David Pine <[email protected]> * Update environment variable format to polyglot-friendly pattern (#5320) * Initial plan * Update environment variable format to polyglot-friendly pattern Co-authored-by: IEvangelist <[email protected]> --------- Co-authored-by: copilot-swe-agent[bot] <[email protected]> Co-authored-by: IEvangelist <[email protected]> * Update AppHost project documentation for Aspire 13.0 SDK format (#5319) * Initial plan * Update AppHost project section to show new SDK format for Aspire 13.0 Co-authored-by: IEvangelist <[email protected]> --------- Co-authored-by: copilot-swe-agent[bot] <[email protected]> Co-authored-by: IEvangelist <[email protected]> * Add AddCSharpApp and CSharpAppResource documentation to app-host-overview.md (#5318) * Initial plan * Add AddCSharpApp and CSharpAppResource documentation to app-host-overview.md Co-authored-by: IEvangelist <[email protected]> * Apply suggestions from code review * Update docs/fundamentals/app-host-overview.md --------- Co-authored-by: copilot-swe-agent[bot] <[email protected]> Co-authored-by: IEvangelist <[email protected]> Co-authored-by: David Pine <[email protected]> * Add breaking changes documentation for pipeline activity reporter API rename (PR #12137) (#5310) * Initial plan * Add breaking changes article for PR #12137 and update documentation Co-authored-by: IEvangelist <[email protected]> * Fix parameter naming consistency in breaking change examples Co-authored-by: IEvangelist <[email protected]> * Fix cross reference warnings by using inline code formatting Co-authored-by: IEvangelist <[email protected]> --------- Co-authored-by: copilot-swe-agent[bot] <[email protected]> Co-authored-by: IEvangelist <[email protected]> Co-authored-by: David Pine <[email protected]> * Add documentation for ASPIREPIPELINES001, ASPIREPIPELINES002, and ASPIREPIPELINES003 diagnostics (#5359) * Initial plan * Add documentation for three new pipeline-related diagnostics Co-authored-by: captainsafia <[email protected]> * Fix ms.date to reflect current date in diagnostic documentation Co-authored-by: captainsafia <[email protected]> * Update diagnostic codes to use ASPIREPIPELINES001-003 instead of mixed naming scheme Co-authored-by: captainsafia <[email protected]> * Add ASPIREPIPELINES001-003 diagnostics to TOC Co-authored-by: IEvangelist <[email protected]> --------- Co-authored-by: copilot-swe-agent[bot] <[email protected]> Co-authored-by: captainsafia <[email protected]> Co-authored-by: IEvangelist <[email protected]> * Add Aspire MCP docs (#5446) * Update configuration * Document deployment state caching (#5301) * Initial plan * Add local deployment state documentation Co-authored-by: IEvangelist <[email protected]> * Address feedback: Add intros, italicize paths, add CI/CD example Co-authored-by: IEvangelist <[email protected]> * Rename and relocate deployment state doc outside Azure section Co-authored-by: IEvangelist <[email protected]> * Clarify cache save behavior in GitHub Actions example Co-authored-by: IEvangelist <[email protected]> --------- Co-authored-by: copilot-swe-agent[bot] <[email protected]> Co-authored-by: IEvangelist <[email protected]> * Add certificate trust customization article for Aspire 13 (#5311) * Initial plan * Add certificate trust customization article Co-authored-by: IEvangelist <[email protected]> * Fix cross-reference title to match actual article title Co-authored-by: IEvangelist <[email protected]> * Address PR feedback: update API examples, add runtime callout, document default scopes Co-authored-by: IEvangelist <[email protected]> * Update callback APIs to use async Task and simplified context objects Co-authored-by: IEvangelist <[email protected]> * Replace deprecated callback APIs with new simplified APIs Co-authored-by: IEvangelist <[email protected]> --------- Co-authored-by: copilot-swe-agent[bot] <[email protected]> Co-authored-by: IEvangelist <[email protected]> * Update documentation for new polyglot environment variables (issue #5308) (#5313) * Initial plan * Update documentation with new polyglot environment variable format Co-authored-by: IEvangelist <[email protected]> * Add clarification about resource names in environment variables Co-authored-by: IEvangelist <[email protected]> * Improve clarity of note about connection name parameter Co-authored-by: IEvangelist <[email protected]> * Update docs/fundamentals/app-host-overview.md --------- Co-authored-by: copilot-swe-agent[bot] <[email protected]> Co-authored-by: IEvangelist <[email protected]> Co-authored-by: David Pine <[email protected]> * Update documentation for Aspire 13 release * Apply suggestions from code review Co-authored-by: Copilot <[email protected]> * fix: build --------- Co-authored-by: Copilot <[email protected]> Co-authored-by: JamesNK <[email protected]> Co-authored-by: James Newton-King <[email protected]> Co-authored-by: IEvangelist <[email protected]> Co-authored-by: captainsafia <[email protected]> Co-authored-by: Copilot <[email protected]>

Initial plan

ab2e03b

Copilot AI assigned Copilot and captainsafia Oct 27, 2025

Copilot started work on behalf of captainsafia October 27, 2025 23:26 View session

Copilot AI and others added 2 commits October 27, 2025 23:32

Add documentation for three new pipeline-related diagnostics

34a4498

Co-authored-by: captainsafia <[email protected]>

Fix ms.date to reflect current date in diagnostic documentation

2afcb1c

Co-authored-by: captainsafia <[email protected]>

Copilot AI changed the title ~~[WIP] Add documentation pages for new diagnostics~~ Add documentation for ASPIREPIPELINES001, ASPIREDEPLOYMENT001, and ASPIREIMGBUILD001 diagnostics Oct 27, 2025

Copilot AI requested a review from captainsafia October 27, 2025 23:36

Copilot finished work on behalf of captainsafia October 27, 2025 23:36

eerhardt reviewed Oct 28, 2025

View reviewed changes

Copilot started work on behalf of captainsafia October 28, 2025 00:15 View session

Update diagnostic codes to use ASPIREPIPELINES001-003 instead of mixe…

5358f9e

…d naming scheme Co-authored-by: captainsafia <[email protected]>

Copilot AI changed the title ~~Add documentation for ASPIREPIPELINES001, ASPIREDEPLOYMENT001, and ASPIREIMGBUILD001 diagnostics~~ Add documentation for ASPIREPIPELINES001, ASPIREPIPELINES002, and ASPIREPIPELINES003 diagnostics Oct 28, 2025

Copilot finished work on behalf of captainsafia October 28, 2025 00:23

eerhardt approved these changes Oct 28, 2025

View reviewed changes

IEvangelist marked this pull request as ready for review October 28, 2025 18:22

IEvangelist self-requested a review as a code owner October 28, 2025 18:22

Copilot started work on behalf of IEvangelist October 28, 2025 18:24 View session

Add ASPIREPIPELINES001-003 diagnostics to TOC

706911d

Co-authored-by: IEvangelist <[email protected]>

Copilot finished work on behalf of IEvangelist October 28, 2025 18:27

IEvangelist merged commit de2d81a into release-13 Oct 28, 2025
12 checks passed

IEvangelist deleted the copilot/create-diagnostic-documentation-pages branch October 28, 2025 18:39

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Add documentation for ASPIREPIPELINES001, ASPIREPIPELINES002, and ASPIREPIPELINES003 diagnostics #5359

Add documentation for ASPIREPIPELINES001, ASPIREPIPELINES002, and ASPIREPIPELINES003 diagnostics #5359

Uh oh!

Copilot AI commented Oct 27, 2025 •

edited by github-actions bot

Loading

Uh oh!

eerhardt Oct 28, 2025

Uh oh!

Copilot AI Oct 28, 2025

Uh oh!

captainsafia Oct 28, 2025

Uh oh!

eerhardt Oct 28, 2025

Uh oh!

Copilot AI Oct 28, 2025

Uh oh!

captainsafia commented Oct 28, 2025

Uh oh!

Copilot AI commented Oct 28, 2025

Uh oh!

IEvangelist commented Oct 28, 2025

Uh oh!

Copilot AI commented Oct 28, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants


		# Compiler Error ASPIREDEPLOYMENT001

		Version introduced: 9.2


		# Compiler Error ASPIREIMGBUILD001

		Version introduced: 9.2

Add documentation for ASPIREPIPELINES001, ASPIREPIPELINES002, and ASPIREPIPELINES003 diagnostics #5359

Add documentation for ASPIREPIPELINES001, ASPIREPIPELINES002, and ASPIREPIPELINES003 diagnostics #5359

Uh oh!

Conversation

Copilot AI commented Oct 27, 2025 • edited by github-actions bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

New diagnostic pages

Changes

Internal previews

Uh oh!

eerhardt Oct 28, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 28, 2025

Choose a reason for hiding this comment

Uh oh!

captainsafia Oct 28, 2025

Choose a reason for hiding this comment

Uh oh!

eerhardt Oct 28, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 28, 2025

Choose a reason for hiding this comment

Uh oh!

captainsafia commented Oct 28, 2025

Uh oh!

Copilot AI commented Oct 28, 2025

Uh oh!

IEvangelist commented Oct 28, 2025

Uh oh!

Copilot AI commented Oct 28, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Copilot AI commented Oct 27, 2025 •

edited by github-actions bot

Loading