Merge pull request #188554 from paulth1/five-iot-hub-device-update-articles

edit pass: Five iot hub device update articles

Author: ShawnJackson

articles/iot-hub-device-update/deploy-update.md

@@ -1,88 +1,89 @@
 ---
-title: Deploy an update using Device Update for Azure IoT Hub | Microsoft Docs
-description: Deploy an update using Device Update for Azure IoT Hub.
+title: Deploy an update by using Device Update for Azure IoT Hub | Microsoft Docs
+description: Deploy an update by using Device Update for Azure IoT Hub.
 author: vimeht
 ms.author: vimeht
 ms.date: 2/11/2021
 ms.topic: how-to
 ms.service: iot-hub-device-update
 ---
 
-# Deploy an Update using Device Update for IoT Hub
+# Deploy an update by using Device Update for Azure IoT Hub
 
-Learn how to deploy an update to an IoT device using Device Update for IoT Hub.
+Learn how to deploy an update to an IoT device by using Device Update for Azure IoT Hub.
 
 ## Prerequisites
 
-* [Access to an IoT Hub with Device Update for IoT Hub enabled](create-device-update-account.md). It is recommended that you use a S1 (Standard) tier or above for your IoT Hub. 
-* [At least one update has been successfully imported for the provisioned device.](import-update.md) 
+* [Access to an IoT hub with Device Update for IoT Hub enabled](create-device-update-account.md). We recommend that you use an S1 (Standard) tier or above for your IoT Hub instance.
+* [At least one update has been successfully imported for the provisioned device](import-update.md).
 * An IoT device (or simulator) provisioned for Device Update within IoT Hub.
-* [The device is part of at least one default group or user-created update group.](create-update-group.md)
+* [The device is part of at least one default group or user-created update group](create-update-group.md).
 * Supported browsers:
   * [Microsoft Edge](https://www.microsoft.com/edge)
   * Google Chrome
 
-## Deploy an update
+## Deploy the update
 
-1. Go to [Azure portal](https://portal.azure.com)
+1. Go to the [Azure portal](https://portal.azure.com).
 
-2. Navigate to the Device Update blade of your IoT Hub.
+1. Go to the **Device Update** pane of your IoT Hub instance.
 
-  :::image type="content" source="media/deploy-update/device-update-iot-hub.png" alt-text="IoT Hub" lightbox="media/deploy-update/device-update-iot-hub.png":::
+    :::image type="content" source="media/deploy-update/device-update-iot-hub.png" alt-text="Screenshot that shows the Get started with the Device Update for IoT Hub page." lightbox="media/deploy-update/device-update-iot-hub.png":::
 
-3. Select the Groups and Deployments tab at the top of the page. [Learn More](device-update-groups.md) about device groups. 
+1. Select the **Groups and Deployments** tab at the top of the page. [Learn more](device-update-groups.md) about device groups.
 
-  :::image type="content" source="media/deploy-update/updated-view.png" alt-text="Groups and Deployments tab" lightbox="media/deploy-update/updated-view.png":::
+   :::image type="content" source="media/deploy-update/updated-view.png" alt-text="Screenshot that shows the Groups and Deployments tab." lightbox="media/deploy-update/updated-view.png":::
 
-4. View the update compliance chart and groups list. You should see a new update available for your device group listed under Best Update (you may need to Refresh once). [Learn More about update compliance.](device-update-compliance.md) 
+1. View the update compliance chart and groups list. You should see a new update available for your device group listed under **Best update**. You might need to refresh once. [Learn more about update compliance](device-update-compliance.md).
 
-5. Select the target group by clicking on the group name. You will be directed to the group details under Group basics.
+1. Select the target group by selecting the group name. You're directed to the group details under **Group basics**.
 
-  :::image type="content" source="media/deploy-update/group-basics.png" alt-text="Group details" lightbox="media/deploy-update/group-basics.png":::
+   :::image type="content" source="media/deploy-update/group-basics.png" alt-text="Screenshot that shows the Group details." lightbox="media/deploy-update/group-basics.png":::
 
-6. To initiate the deployment, go to the Current deployment tab. Click the deploy link next to the desired update from the Available updates section. The best, available update for a given group will be denoted with a "Best" highlight. 
+1. To start the deployment, go to the **Current deployment** tab. Select the deploy link next to the desired update from the **Available updates** section. The best available update for a given group is denoted with a **Best** highlight.
 
-  :::image type="content" source="media/deploy-update/select-update.png" alt-text="Select update" lightbox="media/deploy-update/select-update.png":::
+   :::image type="content" source="media/deploy-update/select-update.png" alt-text="Screenshot that shows Best highlighted." lightbox="media/deploy-update/select-update.png":::
+
+1. Schedule your deployment to start immediately or in the future. Then select **Create**.
 
-7. Schedule your deployment to start immediately or in the future, then select Create.
    > [!TIP]
-   > By default the Start date/time is 24 hrs from your current time. Be sure to select a different date/time if you want the deployment to begin earlier.
- :::image type="content" source="media/deploy-update/create-deployment.png" alt-text="Create deployment" lightbox="media/deploy-update/create-deployment.png":::
+   > By default, the **Start** date and time is 24 hours from your current time. Be sure to select a different date and time if you want the deployment to begin earlier.
 
-8. The Status under Deployment details should turn to Active, and the deployed update should be marked with "(deploying)".
+   :::image type="content" source="media/deploy-update/create-deployment.png" alt-text="Screenshot that shows the Create deployment screen" lightbox="media/deploy-update/create-deployment.png":::
 
- :::image type="content" source="media/deploy-update/deployment-active.png" alt-text="Deployment active" lightbox="media/deploy-update/deployment-active.png":::
+1. Under **Deployment details**, **Status** turns to **Active**. The deployed update is marked with **(deploying)**.
 
-9. View the compliance chart. You should see the update is now in progress. 
+   :::image type="content" source="media/deploy-update/deployment-active.png" alt-text="Screenshot that shows deployment as Active." lightbox="media/deploy-update/deployment-active.png":::
 
-   :::image type="content" source="media/deploy-update/update-in-progress.png" alt-text="Update in progress" lightbox="media/deploy-update/update-in-progress.png":::
+1. View the compliance chart to see that the update is now in progress.
 
-10. After your device is successfully updated, you should see your compliance chart and deployment details update to reflect the same. 
+   :::image type="content" source="media/deploy-update/update-in-progress.png" alt-text="Screenshot that shows Updates in progress." lightbox="media/deploy-update/update-in-progress.png":::
 
-   :::image type="content" source="media/deploy-update/update-succeeded.png" alt-text="Update succeeded" lightbox="media/deploy-update/update-succeeded.png":::
+1. After your device is successfully updated, you see that your compliance chart and deployment details updated to reflect the same.
 
-## Monitor an update deployment
+   :::image type="content" source="media/deploy-update/update-succeeded.png" alt-text="Screenshot that shows the update succeeded." lightbox="media/deploy-update/update-succeeded.png":::
 
-1. Select the Deployment history tab at the top of the page.
+## Monitor the update deployment
 
-   :::image type="content" source="media/deploy-update/deployments-history.png" alt-text="Deployment History" lightbox="media/deploy-update/deployments-history.png":::
+1. Select the **Deployment history** tab at the top of the page.
 
-2. Select the details link next to the deployment you created.
+   :::image type="content" source="media/deploy-update/deployments-history.png" alt-text="Screenshot that shows the Deployment history tab." lightbox="media/deploy-update/deployments-history.png":::
 
-   :::image type="content" source="media/deploy-update/deployment-details.png" alt-text="Deployment details" lightbox="media/deploy-update/deployment-details.png":::
+1. Select **Details** next to the deployment you created.
 
-3. Select Refresh to view the latest status details. 
+   :::image type="content" source="media/deploy-update/deployment-details.png" alt-text="Screenshot that shows deployment details." lightbox="media/deploy-update/deployment-details.png":::
 
+1. Select **Refresh** to view the latest status details.
 
 ## Retry an update deployment
 
-If your deployment fails for some reason, you can retry the deployment for failed devices. 
+If your deployment fails for some reason, you can retry the deployment for failed devices.
 
-1. Go to the Current deployment tab from the group details.  
+1. Go to the **Current deployment** tab on the **Group details** screen.
 
-    :::image type="content" source="media/deploy-update/deployment-active.png" alt-text="Deployment active" lightbox="media/deploy-update/deployment-active.png":::
+    :::image type="content" source="media/deploy-update/deployment-active.png" alt-text="Screenshot that shows the deployment as Active." lightbox="media/deploy-update/deployment-active.png":::
 
-2. Click on "Retry failed devices" and acknowledge the confirmation notification. 
+1. Select **Retry failed devices** and acknowledge the confirmation notification.
 
 ## Next steps
 

articles/iot-hub-device-update/device-update-agent-provisioning.md

@@ -91,7 +91,7 @@ Follow these instructions to provision the Device Update agent on [IoT Edge enab
 
 1. Install the Device Update image update agent.
 
-    We provide sample images in the [Assets here](https://github.com/Azure/iot-hub-device-update/releases) repository. The swUpdate file is the base image that you can flash onto a Raspberry Pi B3+ board. The .gz file is the update you would import through Device Update for IoT Hub. For an example, see [How to flash the image to your IoT Hub device](./device-update-raspberry-pi.md#flash-sd-card-with-image).  
+    We provide sample images in the [Assets here](https://github.com/Azure/iot-hub-device-update/releases) repository. The swUpdate file is the base image that you can flash onto a Raspberry Pi B3+ board. The .gz file is the update you would import through Device Update for IoT Hub. For an example, see [How to flash the image to your IoT Hub device](./device-update-raspberry-pi.md#flash-an-sd-card-with-the-image).  
 
 1. Install the Device Update package update agent.
 
@@ -121,7 +121,7 @@ Follow these instructions to provision the Device Update agent on your IoT Linux
 
 2. Configure the IoT Identity Service by following the instructions in [Configuring the Azure IoT Identity Service](https://azure.github.io/iot-identity-service/configuration.html). 
 
-3. Finally install the Device Update agent. We provide sample images in [Assets here](https://github.com/Azure/iot-hub-device-update/releases), the swUpdate file is the base image that you can flash onto a Raspberry Pi B3+ board, and the .gz file is the update you would import through Device Update for IoT Hub. See example of [how to flash the image to your IoT Hub device](./device-update-raspberry-pi.md#flash-sd-card-with-image).
+3. Finally install the Device Update agent. We provide sample images in [Assets here](https://github.com/Azure/iot-hub-device-update/releases), the swUpdate file is the base image that you can flash onto a Raspberry Pi B3+ board, and the .gz file is the update you would import through Device Update for IoT Hub. See example of [how to flash the image to your IoT Hub device](./device-update-raspberry-pi.md#flash-an-sd-card-with-the-image).
 
 4. After you've installed the device update agent, you will need to edit the configuration file for Device Update by running the command below. 
 
@@ -136,7 +136,7 @@ Follow these instructions to provision the Device Update agent on your IoT Linux
 
 The Device Update agent can also be configured without the IoT Identity service for testing or on constrained devices. Follow the below steps to provision the Device Update agent using a connection string (from the Module or Device).
 
-1. We provide sample images in the [Assets here](https://github.com/Azure/iot-hub-device-update/releases) repository. The swUpdate file is the base image that you can flash onto a Raspberry Pi B3+ board. The .gz file is the update you would import through Device Update for IoT Hub. For an example, see [How to flash the image to your IoT Hub device](./device-update-raspberry-pi.md#flash-sd-card-with-image).
+1. We provide sample images in the [Assets here](https://github.com/Azure/iot-hub-device-update/releases) repository. The swUpdate file is the base image that you can flash onto a Raspberry Pi B3+ board. The .gz file is the update you would import through Device Update for IoT Hub. For an example, see [How to flash the image to your IoT Hub device](./device-update-raspberry-pi.md#flash-an-sd-card-with-the-image).
 
 1. Log onto the machine or IoT Edge device/IoT device.