Address feedback.

Author: dominicbetts

articles/iot-central/core/tutorial-connect-device.md

@@ -77,7 +77,7 @@ In this tutorial, you learn how to:
 
 You can use the **Raw data** view to examine the raw data your device is sending to IoT Central:
 
-:::image type="content" source="media/tutorial-connect-device/raw-data.png" alt-text="The raw data view" lightbox="media/tutorial-connect-device/raw-data.png":::
+:::image type="content" source="media/tutorial-connect-device/raw-data.png" alt-text="Screenshot that shows the raw data view." lightbox="media/tutorial-connect-device/raw-data.png":::
 
 On this view, you can select the columns to display and set a time range to view. The **Unmodeled data** column shows device data that doesn't match any property or telemetry definitions in the device template.
 

articles/iot-central/core/tutorial-create-telemetry-rules.md

@@ -79,9 +79,9 @@ To create a telemetry rule, the device template must include at least one teleme
 
 1. Enter the name _Temperature monitor_ to identify the rule and press Enter.
 
-1. Select the **Sensor Controller** device template. By default, the rule automatically applies to all the devices assigned to the device template: 
+1. Select the **Sensor Controller** device template. By default, the rule automatically applies to all the devices assigned to the device template:
 
-    :::image type="content" source="media/tutorial-create-telemetry-rules/device-filters.png" alt-text="Screenshot that shows the selection of the device template in the rule definition" lightbox="media/tutorial-create-telemetry-rules/device-filters.png":::
+    :::image type="content" source="media/tutorial-create-telemetry-rules/device-filters.png" alt-text="Screenshot that shows the selection of the device template in the rule definition." lightbox="media/tutorial-create-telemetry-rules/device-filters.png":::
 
     To filter for a subset of the devices, select **+ Filter** and use device properties to identify the devices. To disable the rule, toggle the **Enabled/Disabled** button.
 
@@ -93,7 +93,7 @@ Conditions define the criteria that the rule monitors. In this tutorial, you con
 
 1. Next, choose **Is greater than** as the **Operator** and enter _70_ as the **Value**:
 
-    :::image type="content" source="media/tutorial-create-telemetry-rules/aggregate-condition-filled-out.png" alt-text="Screenshot that shows the aggregate condition filled out" lightbox="media/tutorial-create-telemetry-rules/aggregate-condition-filled-out.png":::
+    :::image type="content" source="media/tutorial-create-telemetry-rules/aggregate-condition-filled-out.png" alt-text="Screenshot that shows the aggregate condition filled out." lightbox="media/tutorial-create-telemetry-rules/aggregate-condition-filled-out.png":::
 
     Optionally, you can set a **Time aggregation**. When you select a time aggregation, you must also select an aggregation type, such as average or sum from the aggregation drop-down.
 
@@ -113,15 +113,15 @@ After you define the condition, you set up the actions to take when the rule fir
     > [!NOTE]
     > Emails are only sent to the users that have been added to the application and have logged in at least once. Learn more about [user management](howto-administer.md) in Azure IoT Central.
 
-    :::image type="content" source="media/tutorial-create-telemetry-rules/configure-action.png" alt-text="Screenshot that shows the email action for the rule" lightbox="media/tutorial-create-telemetry-rules/configure-action.png":::
+    :::image type="content" source="media/tutorial-create-telemetry-rules/configure-action.png" alt-text="Screenshot that shows the email action for the rule." lightbox="media/tutorial-create-telemetry-rules/configure-action.png":::
 
 1. To save the action, choose **Done**. You can add multiple actions to a rule.
 
 1. To save the rule, choose **Save**. The rule goes live within a few minutes and starts monitoring telemetry being sent to your application. When the condition specified in the rule is met, the rule triggers the configured email action.
 
 After a while, you receive an email message when the rule fires:
 
-:::image type="content" source="media/tutorial-create-telemetry-rules/email.png" alt-text="Screenshot that shows notification email" lightbox="media/tutorial-create-telemetry-rules/email.png":::
+:::image type="content" source="media/tutorial-create-telemetry-rules/email.png" alt-text="Screenshot that shows notification email." lightbox="media/tutorial-create-telemetry-rules/email.png":::
 
 ## Delete a rule
 

articles/iot-central/core/tutorial-define-gateway-device-type.md

@@ -17,7 +17,7 @@ This tutorial shows you how to use a gateway device template to define a gateway
 
 In this tutorial, you create a **Smart Building** gateway device template. A **Smart Building** gateway device has relationships with other downstream devices.
 
-![Diagram of relationship between gateway device and downstream devices](./media/tutorial-define-gateway-device-type/gatewaypattern.png)
+:::image type="content" source="media/tutorial-define-gateway-device-type/gatewaypattern.png" alt-text="Diagram that shows the relationship between a gateway device and its downstream devices." border="false":::
 
 As well as enabling downstream devices to communicate with your IoT Central application, a gateway device can also:
 

articles/iot-central/core/tutorial-use-device-groups.md

@@ -68,11 +68,11 @@ Now publish the device template.
 
 Before you create a device group, add at least five simulated devices based on the **Sensor Controller** device template to use in this tutorial:
 
-:::image type="content" source="media/tutorial-use-device-groups/simulated-devices.png" alt-text="Screenshot showing five simulated sensor controller devices" lightbox="media/tutorial-use-device-groups/simulated-devices.png":::
+:::image type="content" source="media/tutorial-use-device-groups/simulated-devices.png" alt-text="Screenshot showing five simulated sensor controller devices." lightbox="media/tutorial-use-device-groups/simulated-devices.png":::
 
 For four of the simulated sensor devices, use the **Manage device** view to set the customer name to *Contoso* and select **Save**.
 
-:::image type="content" source="media/tutorial-use-device-groups/customer-name.png" alt-text="Screenshot that shows how to set the Customer Name cloud property" lightbox="media/tutorial-use-device-groups/customer-name.png":::
+:::image type="content" source="media/tutorial-use-device-groups/customer-name.png" alt-text="Screenshot that shows how to set the Customer Name cloud property." lightbox="media/tutorial-use-device-groups/customer-name.png":::
 
 ## Create a device group
 
@@ -92,7 +92,7 @@ For four of the simulated sensor devices, use the **Manage device** view to set
 
 1. Choose **Save**.
 
-:::image type="content" source="media/tutorial-use-device-groups/device-group-query.png" alt-text="Screenshot that shows the device group query configuration" lightbox="media/tutorial-use-device-groups/device-group-query.png":::
+:::image type="content" source="media/tutorial-use-device-groups/device-group-query.png" alt-text="Screenshot that shows the device group query configuration." lightbox="media/tutorial-use-device-groups/device-group-query.png":::
 
 > [!NOTE]
 > For Azure IoT Edge devices, select Azure IoT Edge templates to create a device group.
@@ -113,7 +113,7 @@ To analyze the telemetry for a device group:
 
     You can customize the view, change the time period shown, and export the data as CSV or view data as table.
 
-    :::image type="content" source="media/tutorial-use-device-groups/export-data.png" alt-text="Screenshot that shows how to export data for the Contoso devices" lightbox="media/tutorial-use-device-groups/export-data.png":::
+    :::image type="content" source="media/tutorial-use-device-groups/export-data.png" alt-text="Screenshot that shows how to export data for the Contoso devices." lightbox="media/tutorial-use-device-groups/export-data.png":::
 
 To learn more about analytics, see [How to use data explorer to analyze device data](howto-create-analytics.md).
 

includes/iot-central-monitor-thermostat.md

@@ -14,11 +14,11 @@ As an operator in your Azure IoT Central application, you can:
 
 * View the telemetry sent by the two thermostat components on the **Overview** page:
 
-    :::image type="content" source="media/iot-central-monitor-thermostat/view-telemetry.png" alt-text="View device telemetry" lightbox="media/iot-central-monitor-thermostat/view-telemetry.png":::
+    :::image type="content" source="media/iot-central-monitor-thermostat/view-telemetry.png" alt-text="Screenshot that shows the device overview page." lightbox="media/iot-central-monitor-thermostat/view-telemetry.png":::
 
 * View the device properties on the **About** page. This page shows the properties from the device information component and the two thermostat components:
 
-    :::image type="content" source="media/iot-central-monitor-thermostat/about-properties.png" alt-text="View device properties" lightbox="media/iot-central-monitor-thermostat/about-properties.png":::
+    :::image type="content" source="media/iot-central-monitor-thermostat/about-properties.png" alt-text="Screenshot that dows the device properties view." lightbox="media/iot-central-monitor-thermostat/about-properties.png":::
 
 ## Customize the device template
 
@@ -62,7 +62,7 @@ The thermostat components in the **Temperature Controller** model include the **
 
 1. Save your changes.
 
-:::image type="content" source="media/iot-central-monitor-thermostat/properties-view.png" alt-text="View for updating property values" lightbox="media/iot-central-monitor-thermostat/properties-view.png":::
+:::image type="content" source="media/iot-central-monitor-thermostat/properties-view.png" alt-text="Screenshot that shows a view for updating property values." lightbox="media/iot-central-monitor-thermostat/properties-view.png":::
 
 ## Publish the device template
 
@@ -74,10 +74,10 @@ An operator can now use the **Properties** view to update the property values, a
 
 * Update writable property values on the **Properties** page:
 
-    :::image type="content" source="media/iot-central-monitor-thermostat/update-properties.png" alt-text="Update the device properties" lightbox="media/iot-central-monitor-thermostat/update-properties.png":::
+    :::image type="content" source="media/iot-central-monitor-thermostat/update-properties.png" alt-text="Screenshot that shows updating the device properties." lightbox="media/iot-central-monitor-thermostat/update-properties.png":::
 
 * Call the commands from the **Commands** page. If you run the status report command, select a date and time for the **Since** parameter before you run it:
 
-    :::image type="content" source="media/iot-central-monitor-thermostat/call-command.png" alt-text="Call the command" lightbox="media/iot-central-monitor-thermostat/call-command.png":::
+    :::image type="content" source="media/iot-central-monitor-thermostat/call-command.png" alt-text="Screenshot that shows calling a command." lightbox="media/iot-central-monitor-thermostat/call-command.png":::
 
-    :::image type="content" source="media/iot-central-monitor-thermostat/command-response.png" alt-text="View the command response" lightbox="media/iot-central-monitor-thermostat/command-response.png":::
+    :::image type="content" source="media/iot-central-monitor-thermostat/command-response.png" alt-text="Screenshot tha shows a command response." lightbox="media/iot-central-monitor-thermostat/command-response.png":::