Merge pull request #206704 from JnHs/jh-arck8-augref1

edit pass for wording and clarity

Author: v-stsavell

articles/azure-arc/kubernetes/agent-upgrade.md

@@ -1,79 +1,79 @@
 ---
-title: "Upgrading Azure Arc-enabled Kubernetes agents"
+title: "Upgrade Azure Arc-enabled Kubernetes agents"
 services: azure-arc
 ms.service: azure-arc
-ms.date: 03/03/2021
+ms.date: 08/02/2022
 ms.topic: how-to
 description: "Control agent upgrades for Azure Arc-enabled Kubernetes"
-keywords: "Kubernetes, Arc, Azure, K8s, containers, agent, upgrade"
+keywords: "Kubernetes, Arc, Azure, K8s, containers, agent, update, auto upgrade"
 ---
 
-# Upgrading Azure Arc-enabled Kubernetes agents
+# Upgrade Azure Arc-enabled Kubernetes agents
 
-Azure Arc-enabled Kubernetes provides auto-upgrade and manual-upgrade capabilities for its agents. If use disable auto-upgrade and instead rely on manual-upgrade, version support policy is applicable for Arc agents and the underlying Kubernetes cluster.
+Azure Arc-enabled Kubernetes provides both automatic and manual upgrade capabilities for its agents. If you disable automatic upgrade and instead rely on manual upgrade, a [version support policy](#version-support-policy) applies for Arc agents and the underlying Kubernetes clusters.
 
-## Toggle auto-upgrade on or off when connecting cluster to Azure Arc
+## Toggle automatic upgrade on or off when connecting cluster to Azure Arc
 
-Azure Arc-enabled Kubernetes provides its agents with out- of-the-box auto-upgrade capabilities.
+By default, Azure Arc-enabled Kubernetes provides its agents with out-of-the-box automatic upgrade capabilities.
 
-The following command connects a cluster to Azure Arc with auto-upgrade **enabled**:
+The following command connects a cluster to Azure Arc with automatic upgrade enabled:
 
 ```azurecli
 az connectedk8s connect --name AzureArcTest1 --resource-group AzureArcTest
 ```
 
-With auto-upgrade enabled, the agent polls Azure hourly for availability of a newer version of agents. If the agent finds an available newer version, it triggers a Helm chart upgrade for the Azure Arc agents.
+With automatic upgrade enabled, the agent polls Azure hourly to check for a newer version. When a newer version becomes available, it triggers a Helm chart upgrade for the Azure Arc agents.
 
-To opt-out of auto-upgrade, specify the `--disable-auto-upgrade` parameter while connecting the cluster to Azure Arc. The following command connects a cluster to Azure Arc with auto-upgrade **disabled**:
+To opt out of automatic upgrade, specify the `--disable-auto-upgrade` parameter while connecting the cluster to Azure Arc.
+
+The following command connects a cluster to Azure Arc with auto-upgrade disabled:
 
 ```azurecli
 az connectedk8s connect --name AzureArcTest1 --resource-group AzureArcTest --disable-auto-upgrade
 ```
 
 > [!TIP]
-> If you plan to disable auto-upgrade, please refer to the [version support policy](#version-support-policy) for Azure Arc-enabled Kubernetes.
+> If you plan to disable automatic upgrade, be aware of the [version support policy](#version-support-policy) for Azure Arc-enabled Kubernetes.
+
+## Toggle automatic upgrade on or off after connecting cluster to Azure Arc
 
-## Toggle auto-upgrade on/off after connecting cluster to Azure Arc
+After you connect a cluster to Azure Arc, you can change the automatic upgrade selection by using the `az connectedk8s update` command and setting `--auto-upgrade` to either true or false.
 
-After you connect a cluster to Azure Arc, you can toggle the auto-upgrade capability with the `az connectedk8s update` command, as shown below:
+The following command turns automatic upgrade off for a connected cluster:
 
 ```azurecli
 az connectedk8s update --name AzureArcTest1 --resource-group AzureArcTest --auto-upgrade false
 ```
 
 ## Manually upgrade agents
 
-If you have disabled auto-upgrade for agents, you can manually initiate upgrades for these agents using the `az connectedk8s upgrade` command as shown below:
-
-```azurecli
-az connectedk8s upgrade -g AzureArcTest1 -n AzureArcTest --agent-version 1.1.0
-```
-
-Azure Arc-enabled Kubernetes follows the standard [semantic versioning scheme](https://semver.org/) of `MAJOR.MINOR.PATCH` for versioning its agents. 
+If you've disabled automatic upgrade, you can manually initiate upgrades for the agents by using the `az connectedk8s upgrade` command. When doing so, you must specify the version to which you want to upgrade.
 
-Each number in the version indicates general compatibility with the previous version:
+Azure Arc-enabled Kubernetes follows the standard [semantic versioning scheme](https://semver.org/) of `MAJOR.MINOR.PATCH` for versioning its agents. Each number in the version indicates general compatibility with the previous version:
 
 * **Major versions** change when there are incompatible API updates or backwards-compatibility may be broken.
 * **Minor versions** change when functionality changes are backwards-compatible to other minor releases.
 * **Patch versions** change when backwards-compatible bug fixes are made.
 
-## Version support policy
+While the schedule may vary, a new minor version of Azure Arc-enabled Kubernetes agents is released approximately once per month.
 
-When you create support issues, Azure Arc-enabled Kubernetes practices the following version support policy:
+The following command upgrades the agent to version 1.1.0:
 
-* Azure Arc-enabled Kubernetes agents have a support window of "N-2" where 'N' is the latest minor release of agents. 
-  * For example, if Azure Arc-enabled Kubernetes introduces 0.28.a today, versions 0.28.a, 0.28.b, 0.27.c, 0.27.d, 0.26.e, and 0.26.f are supported by Azure Arc.
+```azurecli
+az connectedk8s upgrade -g AzureArcTest1 -n AzureArcTest --agent-version 1.1.0
+```
 
-* Kubernetes clusters connecting to Azure Arc have a support window of "N-2", where 'N' is the latest stable minor release of [upstream Kubernetes](https://github.com/kubernetes/kubernetes/releases). 
-  * For example, if Kubernetes introduces 1.20.a today, versions 1.20.a, 1.20.b, 1.19.c, 1.19.d, 1.18.e, and 1.18.f are supported.
+## Version support policy
 
-### How often are minor version releases of Azure Arc-enabled Kubernetes available?
+When you [create support requests](/azure/azure-portal/supportability/how-to-create-azure-support-request) for Azure Arc-enabled Kubernetes, the following version support policy applies:
 
-One minor version of Azure Arc-enabled Kubernetes agents is released approximately once a month.
+* Azure Arc-enabled Kubernetes agents have a support window of "N-2", where 'N' is the latest minor release of agents.
+  * For example, if Azure Arc-enabled Kubernetes introduces 0.28.a today, versions 0.28.a, 0.28.b, 0.27.c, 0.27.d, 0.26.e, and 0.26.f are supported.
 
-### What happens if I'm using an agent version or a Kubernetes version outside the official support window?
+* Kubernetes clusters connecting to Azure Arc have a support window of "N-2", where 'N' is the latest stable minor release of [upstream Kubernetes](https://github.com/kubernetes/kubernetes/releases).
+  * For example, if Kubernetes introduces 1.20.a today, versions 1.20.a, 1.20.b, 1.19.c, 1.19.d, 1.18.e, and 1.18.f are supported.
 
-'Outside of Support' means that the versions you're running are outside the "N-2" supported versions of agents and upstream Kubernetes clusters. To proceed with the support issue, you'll be asked to upgrade the cluster and the agents to a supported version.
+If you create a support request and are using a version that is outside of the support policy (older than the "N-2" supported versions of agents and upstream Kubernetes clusters), you'll be asked to upgrade the clusters and agents to a supported version.
 
 ## Next steps