clarify manually updating Dapr versions

Signed-off-by: Hannah Hunter <[email protected]>

Author: hhunter-ms

articles/aks/dapr-overview.md

@@ -65,25 +65,7 @@ Microsoft provides best-effort support for [the latest version of Dapr and two p
 
 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:
-
-```azurecli
-az k8s-extension extension-types list-versions-by-cluster --resource-group myResourceGroup --cluster-name myCluster --cluster-type managedClusters --extension-type microsoft.dapr --release-train stable
-```
-
-To see the latest stable Dapr version available to your managed AKS cluster, run the following:
-
-```azurecli
-az k8s-extension extension-types list-versions-by-cluster --resource-group myResourceGroup --cluster-name myCluster --cluster-type managedClusters --extension-type microsoft.dapr  --release-train stable --show-latest
-```
-
-To view a list of the stable Dapr versions available _by location_:
-1. [Make sure you've registered the `ExtenstionTypes` feature to your Azure subscription.](./dapr.md#register-the-extenstiontypes-feature-to-your-azure-subscription)
-1. Run the following command.
-
-```azurecli
-az k8s-extension extension-types list-versions-by-location --location westus --extension-type microsoft.dapr
-```
+[Learn how to view and target the latest stable Dapr versions available to your managed AKS cluster.](./dapr.md#viewing-the-latest-stable-dapr-versions-available)
 
 ### Runtime support
 

articles/aks/dapr.md

@@ -126,10 +126,29 @@ az k8s-extension create --cluster-type managedClusters \
 --auto-upgrade-minor-version false
 ```
 
-### Configuring automatic updates to Dapr control plane
+### Keep your managed AKS cluster updated to the latest version
+
+Based on your environment (dev, test, or production), you can keep up-to-date with the latest stable Dapr versions. 
+
+### Choosing a release train
+
+When configuring the extension, you can choose to install Dapr from a particular release train. Specify one of the two release train values:
+
+| Value    | Description                               |
+| -------- | ----------------------------------------- |
+| `stable` | Default.                                  |
+| `dev`    | Early releases, can contain experimental features. Not suitable for production. |
+
+For example:
+
+```azurecli
+--release-train stable
+```
+
+#### Configuring automatic updates to Dapr control plane
 
 > [!WARNING]
-> You can enable automatic updates to the Dapr control plane only in dev or test environments. Auto-upgrade is not suitable for production environments.
+> Auto-upgrade is not suitable for production environments. Only enable automatic updates to the Dapr control plane in dev or test environments. [Learn how to manually upgrade to the latest Dapr version for production environments.](#viewing-the-latest-stable-dapr-versions-available)
 
 If you install Dapr without specifying a version, `--auto-upgrade-minor-version` *is automatically enabled*, configuring the Dapr control plane to automatically update its minor version on new releases.
 
@@ -141,12 +160,36 @@ You can disable auto-update by specifying the `--auto-upgrade-minor-version` par
 --auto-upgrade-minor-version true
 ```
 
+### Viewing the latest stable Dapr versions available 
+
+To upgrade to the latest Dapr version in a production environment, you need to manually upgrade. Start by viewing a list of the stable Dapr versions available to your managed AKS cluster. Run the following command:
+
+```azurecli
+az k8s-extension extension-types list-versions-by-cluster --resource-group myResourceGroup --cluster-name myCluster --cluster-type managedClusters --extension-type microsoft.dapr --release-train stable
+```
+
+To see the latest stable Dapr version available to your managed AKS cluster, run the following:
+
+```azurecli
+az k8s-extension extension-types list-versions-by-cluster --resource-group myResourceGroup --cluster-name myCluster --cluster-type managedClusters --extension-type microsoft.dapr  --release-train stable --show-latest
+```
+
+To view a list of the stable Dapr versions available _by location_:
+1. [Make sure you've registered the `ExtenstionTypes` feature to your Azure subscription.](./dapr.md#register-the-extenstiontypes-feature-to-your-azure-subscription)
+1. Run the following command.
+
+```azurecli
+az k8s-extension extension-types list-versions-by-location --location westus --extension-type microsoft.dapr
+```
+
+[Next, manually update Dapr to the latest stable version.](#targeting-a-specific-dapr-version)
+
 ### Targeting a specific Dapr version
 
 > [!NOTE]
 > Dapr is supported with a rolling window, including only the current and previous versions. It is your operational responsibility to remain up to date with these supported versions. If you have an older version of Dapr, you may have to do intermediate upgrades to get to a supported version.
 
-The same command-line argument is used for installing a specific version of Dapr or rolling back to a previous version. Set `--auto-upgrade-minor-version` to `false` and `--version` to the version of Dapr you wish to install. If the `version` parameter is omitted, the extension installs the latest version of Dapr. For example, to use Dapr 1.11.2:
+The same command-line argument is used for installing a specific version of Dapr or rolling back to a previous version. Set `--auto-upgrade-minor-version` to `false` and `--version` to the version of Dapr you wish to install. If the `version` parameter is omitted, the extension installs the latest version of Dapr. For example, to use Dapr 1.13.5:
 
 ```azurecli
 az k8s-extension create --cluster-type managedClusters \
@@ -155,22 +198,7 @@ az k8s-extension create --cluster-type managedClusters \
 --name dapr \
 --extension-type Microsoft.Dapr \
 --auto-upgrade-minor-version false \
---version 1.11.2
-```
-
-### Choosing a release train
-
-When configuring the extension, you can choose to install Dapr from a particular release train. Specify one of the two release train values:
-
-| Value    | Description                               |
-| -------- | ----------------------------------------- |
-| `stable` | Default.                                  |
-| `dev`    | Early releases, can contain experimental features. Not suitable for production. |
-
-For example:
-
-```azurecli
---release-train stable
+--version 1.13.5
 ```
 
 # [Bicep](#tab/bicep)