Rename and relocate deployment state doc outside Azure section

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>

Author: Copilot

.openpublishing.redirection.json

@@ -335,6 +335,10 @@
     {
       "source_path_from_root": "/docs/fundamentals/build-container-images.md",
       "redirect_url": "/dotnet/aspire/fundamentals/custom-deployments"
+    },
+    {
+      "source_path_from_root": "/docs/deployment/aspire-deploy/local-deployment-state.md",
+      "redirect_url": "/dotnet/aspire/deployment/deployment-state-caching"
     }
   ]
 }

docs/cli-reference/aspire-deploy.md

@@ -113,4 +113,4 @@ The following options are available:
 
 ## See also
 
-- [Local deployment state](../deployment/aspire-deploy/local-deployment-state.md)
+- [Deployment state caching](../deployment/deployment-state-caching.md)

docs/deployment/aspire-deploy/aca-deployment-aspire-cli.md

@@ -139,7 +139,7 @@ Save to user secrets: [y/n] (n): n
 ```
 
 > [!NOTE]
-> The CLI continuously prompts until all unresolved parameters are provided with values. The `aspire deploy` command caches deployment state locally to streamline subsequent deployments. For more information, see [Local deployment state](local-deployment-state.md).
+> The CLI continuously prompts until all unresolved parameters are provided with values. The `aspire deploy` command caches deployment state locally to streamline subsequent deployments. For more information, see [Deployment state caching](../deployment-state-caching.md).
 
 Once parameters are collected, Azure infrastructure is provisioned using Bicep templates. This step creates the necessary Azure resources including the Container Apps environment, Container Registry, and any backing services like Redis caches:
 

docs/deployment/aspire-deploy/local-deployment-state.md renamed to docs/deployment/deployment-state-caching.md

@@ -1,11 +1,11 @@
 ---
-title: Local deployment state
+title: Deployment state caching
 description: Learn how the aspire deploy command manages deployment state through cached configuration files.
 ms.date: 10/17/2025
 ai-usage: ai-assisted
 ---
 
-# Local deployment state
+# Deployment state caching
 
 The `aspire deploy` command manages deployment state through cached configuration files stored locally on your machine. This caching mechanism streamlines repeated deployments by preserving provisioning settings and parameters, making subsequent deployments faster and more efficient.
 
@@ -167,5 +167,5 @@ Consider these security best practices:
 
 ## See also
 
-- [aspire deploy command reference](../../cli-reference/aspire-deploy.md)
-- [Deploy to Azure Container Apps using Aspire CLI](aca-deployment-aspire-cli.md)
+- [aspire deploy command reference](../cli-reference/aspire-deploy.md)
+- [Deploy to Azure Container Apps using Aspire CLI](aspire-deploy/aca-deployment-aspire-cli.md)

docs/toc.yml

@@ -491,16 +491,16 @@ items:
     href: deployment/overview.md
   - name: Building custom deployment pipelines
     href: fundamentals/custom-deployments.md
+  - name: Deployment state caching
+    href: deployment/deployment-state-caching.md
+    displayName: deployment state,deployment cache,clear-cache,deployment settings,aspire deploy
   - name: Azure deployment with Aspire
     items:
     - name: Deploy to Azure Container Apps using Aspire CLI
       href: deployment/aspire-deploy/aca-deployment-aspire-cli.md
     - name: Deploy to Azure Container Apps using Visual Studio
       href: deployment/aspire-deploy/aca-deployment-visual-studio.md
       displayName: azure container apps,vs
-    - name: Local deployment state
-      href: deployment/aspire-deploy/local-deployment-state.md
-      displayName: deployment state,deployment cache,clear-cache,deployment settings
     - name: Azure security best practices
       href: deployment/aspire-deploy/azure-security-best-practices.md
       displayName: azure security,security best practices,container security,managed identity