From c8cbee309fb8ff9643618a2334369c098a0ebf21 Mon Sep 17 00:00:00 2001
From: "aspire-repo-bot[bot]"
 <268009190+aspire-repo-bot[bot]@users.noreply.github.com>
Date: Fri, 9 Oct 2026 01:41:27 +0000
Subject: [PATCH] docs: graduate ASPIREPIPELINES002 deployment state APIs to
 stable in 17.0

Documents the graduation of IDeploymentStateManager and
DeploymentStateSection from experimental to stable, matching
microsoft/aspire#20816.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 .../docs/diagnostics/aspirepipelines002.mdx    |  8 +++++++-
 .../src/content/docs/diagnostics/overview.mdx  |  2 +-
 .../src/content/docs/whats-new/aspire-17.mdx   | 18 ++++++++++++++++++
 3 files changed, 26 insertions(+), 2 deletions(-)

diff --git a/src/frontend/src/content/docs/diagnostics/aspirepipelines002.mdx b/src/frontend/src/content/docs/diagnostics/aspirepipelines002.mdx
index 6078c9cd2..646defe31 100644
--- a/src/frontend/src/content/docs/diagnostics/aspirepipelines002.mdx
+++ b/src/frontend/src/content/docs/diagnostics/aspirepipelines002.mdx
@@ -19,6 +19,10 @@ Aspire introduced deployment state manager APIs as part of the pipeline infrastr
 
 Deployment state manager APIs are considered experimental and are expected to change in future updates.
 
+:::note
+In Aspire 17.0, `IDeploymentStateManager` and `DeploymentStateSection` graduated from experimental and no longer trigger this diagnostic.
+:::
+
 ## APIs affected
 
 This diagnostic applies to the following deployment state manager APIs:
@@ -30,7 +34,9 @@ This diagnostic applies to the following deployment state manager APIs:
 
 ## To correct this error
 
-Suppress the error with one of the following methods:
+If you use Aspire 17.0 or later, you don't need to suppress this diagnostic and can remove any existing `ASPIREPIPELINES002` suppressions.
+
+If you use an Aspire version earlier than 17.0, suppress the diagnostic with one of the following methods:
 
 - Set the severity of the rule in the _.editorconfig_ file.
 
diff --git a/src/frontend/src/content/docs/diagnostics/overview.mdx b/src/frontend/src/content/docs/diagnostics/overview.mdx
index 9e0b41b8e..f821b5dc4 100644
--- a/src/frontend/src/content/docs/diagnostics/overview.mdx
+++ b/src/frontend/src/content/docs/diagnostics/overview.mdx
@@ -58,7 +58,7 @@ The following table lists the possible MSBuild and analyzer warnings and errors
 | [ASPIREMCP001](/diagnostics/aspiremcp001/)                                         | (Experimental) Warning | <abbr title="Model Context Protocol" data-tooltip-placement="top">MCP</abbr> server types and members are for evaluation purposes only and are subject to change or removal in future updates. |
 | [ASPIREPERSISTENCE001](/diagnostics/aspirepersistence001/)                         | (Experimental) Error   | Resource lifetime types and members are for evaluation purposes only and are subject to change or removal in future updates.                                                                   |
 | [ASPIREPIPELINES001](/diagnostics/aspirepipelines001/)                             | (Experimental) Error   | Pipeline infrastructure APIs are for evaluation purposes only and are subject to change or removal in future updates.                                                                          |
-| [ASPIREPIPELINES002](/diagnostics/aspirepipelines002/)                             | (Experimental) Error   | Deployment state manager APIs are for evaluation purposes only and are subject to change or removal in future updates.                                                                         |
+| [ASPIREPIPELINES002](/diagnostics/aspirepipelines002/)                             | (Experimental) Error   | Graduated to stable in Aspire 17.0. `IDeploymentStateManager` and `DeploymentStateSection` no longer require suppressing this diagnostic.                                                      |
 | [ASPIREPIPELINES003](/diagnostics/aspirepipelines003/)                             | (Experimental) Error   | Container image build APIs are for evaluation purposes only and are subject to change or removal in future updates.                                                                            |
 | [ASPIREPIPELINES004](/diagnostics/aspirepipelines004/)                             | (Experimental) Warning | Type is for evaluation purposes only and is subject to change or removal in future updates.                                                                                                    |
 | [ASPIREPOSTGRES001](/diagnostics/aspirepostgres001/)                               | (Experimental) Warning | PostgreSQL MCP integration is for evaluation purposes only and is subject to change or removal in future updates.                                                                              |
diff --git a/src/frontend/src/content/docs/whats-new/aspire-17.mdx b/src/frontend/src/content/docs/whats-new/aspire-17.mdx
index 4c5cbc2c5..8e5bf8d5f 100644
--- a/src/frontend/src/content/docs/whats-new/aspire-17.mdx
+++ b/src/frontend/src/content/docs/whats-new/aspire-17.mdx
@@ -76,3 +76,21 @@ The service registration calls, `AddRabbitMQClient` and `AddMongoDBClient`, rema
   current client setup guidance. For the removal details, see
   [microsoft/aspire#20608](https://github.com/microsoft/aspire/pull/20608).
 </LearnMore>
+
+## 🚀 Pipelines and deployment
+
+### Deployment state manager APIs are stable
+
+The deployment state manager APIs — `IDeploymentStateManager` and `DeploymentStateSection` — have graduated to stable. You can use them to store, retrieve, and clear deployment artifacts and metadata across pipeline executions without suppressing `ASPIREPIPELINES002`.
+
+```csharp
+var section = await stateManager.AcquireSectionAsync("Parameters");
+section.Data["key1"] = "value1";
+await stateManager.SaveSectionAsync(section);
+```
+
+All signatures, defaults, and persistence behavior are unchanged from the experimental release.
+
+<LearnMore>
+  For diagnostic details, see [ASPIREPIPELINES002](/diagnostics/aspirepipelines002/).
+</LearnMore>