Merge pull request #280999 from hhunter-ms/hh-286142

[Dapr/AKS] Improve cross-linking

Author: v-dirichards

articles/aks/TOC.yml

@@ -182,7 +182,7 @@
       href: concepts-sustainable-software-engineering.md
     - name: Preview API life cycle
       href: concepts-preview-api-life-cycle.md
-    - name: Dapr
+    - name: Dapr extension
       href: dapr-overview.md
     - name: GitOps
       href: ../azure-arc/kubernetes/conceptual-gitops-flux2.md?toc=/azure/aks/toc.json&bc=/azure/aks/breadcrumb/toc.json
@@ -879,7 +879,7 @@
               href: deploy-application-az-cli.md
         - name: Dapr
           items:
-            - name: Create the Dapr extension
+            - name: Install the Dapr extension
               href: dapr.md
             - name: Configure the Dapr extension
               href: dapr-settings.md

articles/aks/dapr-overview.md

@@ -1,12 +1,12 @@
 ---
-title: Dapr extension for Azure Kubernetes Service (AKS) overview
+title: Dapr extension for Azure Kubernetes Service (AKS) and Arc-enabled Kubernetes
 description: Learn more about using Dapr on your Azure Kubernetes Service (AKS) cluster to develop applications.
 ms.author: nickoman
 ms.topic: overview
 ms.date: 04/22/2024
 ---
 
-# Dapr
+# Dapr extension for Azure Kubernetes Service (AKS) and Arc-enabled Kubernetes
 
 [Distributed Application Runtime (Dapr)][dapr-docs] offers APIs that help you write and implement simple, portable, resilient, and secured microservices. Dapr APIs run as a sidecar process in tandem with your applications and abstract away common complexities you may encounter when building distributed applications, such as:
 - Service discovery
@@ -19,7 +19,7 @@ Dapr is incrementally adoptable. You can use any of the API building blocks as n
 
 ## Capabilities and features
 
-[Using the Dapr extension to provision Dapr on your AKS or Arc-enabled Kubernetes cluster](../azure-arc/kubernetes/conceptual-extensions.md) eliminates the overhead of:
+[Using the Dapr extension to provision Dapr on your AKS or Arc-enabled Kubernetes cluster][dapr-create-extension] eliminates the overhead of:
 - Downloading Dapr tooling
 - Manually installing and managing the Dapr runtime on your AKS cluster
 
@@ -63,7 +63,7 @@ Microsoft provides best-effort support for [the latest version of Dapr and two p
 - 1.12.x 
 - 1.11.x 
 
-You can run Azure CLI commands to retreive a list of available versions in [a cluster](/cli/azure/k8s-extension/extension-types#az-k8s-extension-extension-types-list-versions-by-cluster) or [a location](/cli/azure/k8s-extension/extension-types#az-k8s-extension-extension-types-list-versions-by-location).
+You can run Azure CLI commands to retrieve a list of available versions in [a cluster](/cli/azure/k8s-extension/extension-types#az-k8s-extension-extension-types-list-versions-by-cluster) or [a location](/cli/azure/k8s-extension/extension-types#az-k8s-extension-extension-types-list-versions-by-location).
 
 To view a list of the stable Dapr versions available to your managed AKS cluster, run the following command:
 
@@ -221,7 +221,9 @@ If you install Dapr through the AKS extension, our recommendation is to continue
 
 ## Next Steps
 
-After learning about Dapr and some of the challenges it solves, try [Deploying an application with the Dapr cluster extension][dapr-quickstart].
+> [!div class="nextstepaction"]
+> [Walk through the Dapr extension quickstart to demo how it works][dapr-quickstart]
+
 
 <!-- Links Internal -->
 [csi-secrets-store]: ./csi-secrets-store-driver.md
@@ -231,6 +233,7 @@ After learning about Dapr and some of the challenges it solves, try [Deploying a
 [dapr-migration]: ./dapr-migration.md
 [aks-msi]: ./use-managed-identity.md
 [dapr-configuration-options]: ./dapr-settings.md
+[dapr-create-extension]: ./dapr.md
 
 <!-- Links External -->
 [dapr-docs]: https://docs.dapr.io/
@@ -248,4 +251,4 @@ After learning about Dapr and some of the challenges it solves, try [Deploying a
 [dapr-subscriptions]: https://docs.dapr.io/developing-applications/building-blocks/pubsub/subscription-methods/#declarative-subscriptions
 [dapr-supported-version]: https://docs.dapr.io/operations/support/support-release-policy/
 [dapr-observability]: https://docs.dapr.io/operations/observability/
-[dapr-alpha-beta]: https://docs.dapr.io/operations/support/alpha-beta-apis/
+[dapr-alpha-beta]: https://docs.dapr.io/operations/support/alpha-beta-apis/

articles/aks/dapr-settings.md

@@ -374,7 +374,9 @@ The Dapr extension requires the following outbound URLs on `https://:443` to fun
 
 ## Next Steps
 
-Once you successfully provisioned Dapr in your AKS cluster, try deploying a [sample application][sample-application].
+- [Walk through the tutorial for deploying Dapr Workflow via the extension][dapr-workflow]
+- [Determine if you need to migrate from Dapr open source to the Dapr extension][dapr-migration].
+
 
 <!-- LINKS INTERNAL -->
 [deploy-cluster]: ./tutorial-kubernetes-deploy-cluster.md
@@ -389,7 +391,7 @@ Once you successfully provisioned Dapr in your AKS cluster, try deploying a [sam
 [dapr-migration]: ./dapr-migration.md
 [dapr-settings]: ./dapr-settings.md
 [aks-azurelinux]: ./cluster-configuration.md#azure-linux-container-host-for-aks
-
+[dapr-workflow]: ./dapr-workflow.md
 
 <!-- LINKS EXTERNAL -->
 [kubernetes-production]: https://docs.dapr.io/operations/hosting/kubernetes/kubernetes-production

articles/aks/dapr-workflow.md

@@ -185,7 +185,8 @@ Notice that the workflow status is marked as completed.
 
 ## Next steps
 
-[Learn how to add configuration settings to the Dapr extension on your AKS cluster][dapr-config].
+- [Configure the Dapr extension on your AKS cluster][dapr-config].
+- [Determine if you need to migrate from Dapr open source to the Dapr extension][dapr-migration].
 
 <!-- Links Internal -->
 [deploy-cluster]: ./tutorial-kubernetes-deploy-cluster.md
@@ -194,6 +195,7 @@ Notice that the workflow status is marked as completed.
 [cluster]: ./tutorial-kubernetes-deploy-cluster.md
 [k8s-sp]: ./dapr.md#register-the-kubernetesconfiguration-resource-provider
 [dapr-config]: ./dapr-settings.md
+[dapr-migration]: ./dapr-migration.md
 [az-cloud-shell]: ./learn/quick-kubernetes-deploy-powershell.md#azure-cloud-shell
 [kubectl]: ./tutorial-kubernetes-deploy-cluster.md#connect-to-cluster-using-kubectl
 

articles/aks/dapr.md

@@ -1,16 +1,16 @@
 ---
-title: Dapr extension for Azure Kubernetes Service (AKS) and Arc-enabled Kubernetes
+title: Install the Dapr extension for Azure Kubernetes Service (AKS) and Arc-enabled Kubernetes
 description: Install and configure Dapr on your Azure Kubernetes Service (AKS) and Arc-enabled Kubernetes clusters using the Dapr cluster extension.
 author: greenie-msft
 ms.author: nigreenf
 ms.service: azure-kubernetes-service
 ms.topic: article
-ms.date: 06/06/2024
+ms.date: 07/16/2024
 ms.subservice: aks-developer
 ms.custom: devx-track-azurecli, references_regions
 ---
 
-# Dapr extension for Azure Kubernetes Service (AKS) and Arc-enabled Kubernetes
+# Install the Dapr extension for Azure Kubernetes Service (AKS) and Arc-enabled Kubernetes
 
 [Dapr](./dapr-overview.md) simplifies building resilient, stateless, and stateful applications that run on the cloud and edge and embrace the diversity of languages and developer frameworks. With Dapr's sidecar architecture, you can keep your code platform agnostic while tackling challenges around building microservices, like:
 - Calling other services reliably and securely
@@ -342,9 +342,8 @@ Or simply remove the Bicep template.
 
 ## Next Steps
 
-- Learn more about [extra settings and preferences you can set on the Dapr extension][dapr-settings].
-- Once you have successfully provisioned Dapr in your AKS cluster, try deploying a [sample application][sample-application].
-- Try out [Dapr Workflow on your Dapr extension for AKS][dapr-workflow]
+> [!div class="nextstepaction"]
+> [Configure the Dapr extension for your unique scenario][dapr-settings]
 
 <!-- LINKS INTERNAL -->
 [deploy-cluster]: ./tutorial-kubernetes-deploy-cluster.md

articles/aks/quickstart-dapr.md

@@ -4,7 +4,7 @@ description: Use the Dapr cluster extension for Azure Kubernetes Service (AKS) o
 author: nickomang
 ms.author: nickoman
 ms.topic: quickstart
-ms.date: 12/27/2023
+ms.date: 07/16/2024
 ms.custom: template-quickstart, mode-other, devx-track-js, devx-track-python
 ---
 
@@ -232,16 +232,17 @@ Now that both the Node.js and Python applications are deployed, you watch messag
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Learn more about other cluster extensions][cluster-extensions].
+> [Learn how to create the Dapr extension][dapr-create-extension]
 
 <!-- LINKS -->
 <!-- INTERNAL -->
 [azure-cli-install]: /cli/azure/install-azure-cli
 [azure-powershell-install]: /powershell/azure/install-az-ps
 [cluster-extensions]: ./cluster-extensions.md
-[dapr-overview]: ./dapr.md
+[dapr-overview]: ./dapr-overview.md
 [az-group-delete]: /cli/azure/group#az-group-delete
 [remove-azresourcegroup]: /powershell/module/az.resources/remove-azresourcegroup
+[dapr-create-extension]: ./dapr.md
 
 <!-- EXTERNAL -->
 [hello-world-gh]: https://github.com/dapr/quickstarts/tree/master/tutorials/hello-kubernetes