copy edits and Acroylinx fixes

Author: ScarlettFalls

articles/iot-edge/how-to-deploy-at-scale.md

@@ -181,6 +181,7 @@ To modify targeted devices for a deployment:
 
 1. In your IoT hub, select **IoT Edge** from the left pane menu.
 1. Select the **IoT Edge deployments** tab and select the deployment you want to configure. Select the **Target Condition** tab.
+1. If needed, adjust the **Priority** for when deployments target the same device, the deployment with higher priority gets applied. If multiple deployments have the same priority, the deployment with the later creation date gets applied.
 1. Define a target condition, using the example syntax as a guide.
 
     ![Specify target conditions for a deployment](./media/how-to-deploy-monitor/target-devices.png)

articles/iot-edge/how-to-monitor-iot-edge-deployments.md

@@ -12,7 +12,7 @@ services: iot-edge
 ---
 # Monitor IoT Edge deployments
 
-Azure IoT Edge provides reporting that lets you monitor real-time information on the modules deployed to your IoT Edge devices. The IoT Hub service retrieves the status from the IoT Edge devices and makes them available to the operator. In addition to the need to monitor deployments made to individual devices, monitoring is important for [deployments made at scale](module-deployment-monitoring.md) that include automatic deployments and layered deployments.
+Azure IoT Edge provides reporting that lets you monitor real-time information on the modules deployed to your IoT Edge devices. The IoT Hub service retrieves the status from the devices and makes them available to the operator. Monitoring is also important for [deployments made at scale](module-deployment-monitoring.md) that include automatic deployments and layered deployments.
 
 Successful deployments require monitoring the following information:
 
@@ -22,21 +22,19 @@ Successful deployments require monitoring the following information:
 
 * Status codes of the IoT Edge runtime modules.
 
-* Versions of deployed modules.
+* Versions of the deployed modules.
 
-Both devices and modules have similar data, such as connectivity, so values are obtained according the device ID or the module ID.
+Both devices and modules have similar data, such as connectivity, so values are obtained according to the device ID or the module ID.
 
-The IoT Hub service collects the data reported by device and module twins and provides aggregated counts of the various states that devices may have. The IoT Hub service organizes this data into four groups of metrics:
+The IoT Hub service collects data reported by device and module twins and provides counts of the various states that devices may have. The IoT Hub service organizes this data into four groups of metrics:
 
 | Type | Description |
 | --- | ---|
-| Targeted | Shows the IoT Edge devices that match the Deployment targeting condition. |
+| Targeted | Shows the IoT Edge devices that match the deployment targeting condition. |
 | Applied | Shows the targeted IoT Edge devices that are not targeted by another deployment of higher priority. |
 | Reporting Success | Shows the IoT Edge devices that have reported that the modules have been deployed successfully. |
 | Reporting Failure | Shows the IoT Edge devices that have reported that one or more modules haven't been deployed successfully. To further investigate the error, connect remotely to those devices and view the log files. |
 
-You can also define your own custom metrics.
-
 The IoT Hub service makes this data available for you to monitor in the Azure portal and in the Azure CLI.
 
 ## Monitor a deployment in the Azure portal
@@ -51,28 +49,28 @@ To view the details of a deployment and monitor the devices running it, use the
     | Column | Description |
     | --- | --- |
     | ID | The name of the deployment. |
-    | Type | The type of deployment, either **Deployment** or **Layered Deployment** |
+    | Type | The type of deployment, either **Deployment** or **Layered Deployment**. |
     | Target Condition | The tag used to define targeted devices. |
     | Priority | The priority number assigned to the deployment. |
-    | System metrics | Specifies the number of device twins in IoT Hub that match the targeting condition, and **Applied** specifies the number of devices that have had the deployment content applied to their module twins in IoT Hub. |
-    | Device Metrics | The number of IoT Edge devices in the deployment  |reporting success or errors from the IoT Edge client runtime. |
-    | Custom Metrics | The number of IoT Edge devices in the deployment  |reporting data for any metrics that you defined for the deployment. |
+    | System metrics | The number of device twins in IoT Hub that match the targeting condition. **Applied** specifies the number of devices that have had the deployment content applied to their module twins in IoT Hub. |
+    | Device Metrics | The number of IoT Edge devices reporting success or errors from the IoT Edge client runtime. |
+    | Custom Metrics | The number of IoT Edge devices reporting data for any metrics that you defined for the deployment. |
     | Creation Time | The timestamp from when the deployment was created. This timestamp is used to break ties when two deployments have the same priority. |
 
 1. Select the deployment that you want to monitor.  
-1. On the **Deployment Details** page, scroll down to the bottom section and select the **Metrics** tab. Use the **Select Metric** drop-down to choose a specific metric. When a metric is selected, the **View** button appears that will list the IoT Edge devices that match the condition for the selected metric.
+1. On the **Deployment Details** page, scroll down to the bottom section and select the **Metrics** tab. Use the **Select Metric** drop-down to choose a specific metric. When a metric is selected, the **View** button appears that lists the IoT Edge devices that match the condition for the selected metric.
 
    ![View metrics for a selected deployment](./media/how-to-monitor-iot-edge-deployments/deployment-metrics-tab.png)
 
-1. Select the **Edit Metrics** button to view and edit the criteria for each metric. In addition to the four default metrics, custom defined metrics will appear in this list.
+1. Select the **Edit Metrics** button to view and edit the criteria for each metric. Also the four default metrics, custom defined metrics will appear in this list.
 
    ![View IoT Edge deployment metric criteria](./media/how-to-monitor-iot-edge-deployments/metric-list.png)
 
 To make changes to your deployment, see [Modify a deployment](how-to-deploy-at-scale.md#modify-a-deployment).
 
 ## Monitor a deployment with Azure CLI
 
-Use the [az iot edge deployment show](https://docs.microsoft.com/cli/azure/ext/azure-cli-iot-ext/iot/edge/deployment?view=azure-cli-latest#ext-azure-cli-iot-ext-az-iot-edge-deployment-show) command to display the details of a single deployment:
+Use the [az IoT Edge deployment show](https://docs.microsoft.com/cli/azure/ext/azure-cli-iot-ext/iot/edge/deployment?view=azure-cli-latest#ext-azure-cli-iot-ext-az-iot-edge-deployment-show) command to display the details of a single deployment:
 
 ```cli
 az iot edge deployment show --deployment-id [deployment id] --hub-name [hub name]
@@ -90,7 +88,7 @@ Inspect the deployment in the command window. The **metrics** property lists a
 * **reportedSuccessfulCount** - A device metric that specifies the number of IoT Edge devices in the deployment reporting success from the IoT Edge client runtime.
 * **reportedFailedCount** - A device metric that specifies the number of IoT Edge devices in the deployment reporting failure from the IoT Edge client runtime.
 
-You can show a list of device IDs or objects for each of the metrics by using the [az iot edge deployment show-metric](https://docs.microsoft.com/cli/azure/ext/azure-cli-iot-ext/iot/edge/deployment?view=azure-cli-latest#ext-azure-cli-iot-ext-az-iot-edge-deployment-show-metric) command:
+You can show a list of device IDs or objects for each of the metrics with the [az IoT Edge deployment show-metric](https://docs.microsoft.com/cli/azure/ext/azure-cli-iot-ext/iot/edge/deployment?view=azure-cli-latest#ext-azure-cli-iot-ext-az-iot-edge-deployment-show-metric) command:
 
 ```cli
 az iot edge deployment show-metric --deployment-id [deployment id] --metric-id [metric id] --hub-name [hub name]
@@ -102,6 +100,8 @@ The deployment show-metric command takes the following parameters:
 * **--metric-id** - The name of the metric for which you want to see the list of device IDs, for example `reportedFailedCount`.
 * **--hub-name** - Name of the IoT hub in which the deployment exists. The hub must be in the current subscription. Switch to the desired subscription with the command `az account set -s [subscription name]`.
 
+To make changes to your deployment, see [Modify a deployment](how-to-deploy-cli-at-scale.md#modify-a-deployment).
+
 ## Next steps
 
-Learn how [communicate with EdgeAgent using built-in direct methods](how-to-edgeagent-direct-method.md).
+Learn how to [communicate with EdgeAgent using built-in direct methods](how-to-edgeagent-direct-method.md).