Merge pull request #216723 from dominicbetts/central-concepts-screenshots

IoT Central: screenshot updates - concepts and how-tos

Author: ttorble

articles/iot-central/core/concepts-device-authentication.md

@@ -3,7 +3,7 @@ title: Device authentication in Azure IoT Central | Microsoft Docs
 description: This article introduces key concepts relating to device authentication in Azure IoT Central
 author: dominicbetts
 ms.author: dobett
-ms.date: 03/02/2022
+ms.date: 10/28/2022
 ms.topic: conceptual
 ms.service: iot-central
 services: iot-central
@@ -118,7 +118,7 @@ To automatically register devices that use SAS tokens:
 
 1. Copy the group primary key from the **SAS-IoT-Devices** enrollment group:
 
-    :::image type="content" source="media/concepts-device-authentication/group-primary-key.png" alt-text="Group primary key from S A S - I o T - Devices enrollment group.":::
+    :::image type="content" source="media/concepts-device-authentication/group-primary-key.png" alt-text="Group primary key from SAS IoT Devices enrollment group." lightbox="media/concepts-device-authentication/group-primary-key.png":::
 
 1. Use the `az iot central device compute-device-key` command to generate the device SAS keys. Use the group primary key from the previous step. The device ID can contain letters, numbers, and the `-` character:
 

articles/iot-central/core/concepts-device-templates.md

@@ -45,7 +45,7 @@ IoT Central can automatically assign a device to a device template when the devi
 
 The following screenshot shows you how to view the model ID of a device template in IoT Central. In a device template, select a component, and then select **Edit identity**:
 
-:::image type="content" source="media/concepts-device-templates/model-id.png" alt-text="Screenshot showing model I D in thermostat device template.":::
+:::image type="content" source="media/concepts-device-templates/model-id.png" alt-text="Screenshot showing model ID in thermostat device template." lightbox="media/concepts-device-templates/model-id.png":::
 
 You can view the [thermostat model](https://github.com/Azure/iot-plugandplay-models/blob/main/dtmi/com/example/thermostat-1.json) in the public model repository. The model ID definition looks like:
 

articles/iot-central/core/concepts-telemetry-properties-commands.md

@@ -44,7 +44,7 @@ IoT Central lets you view the raw data that a device sends to an application. Th
 
 1. Select the **Raw data** tab:
 
-    :::image type="content" source="media/concepts-telemetry-properties-commands/raw-data.png" alt-text="Raw data view":::
+    :::image type="content" source="media/concepts-telemetry-properties-commands/raw-data.png" alt-text="Screenshot that shows the raw data view." lightbox="media/concepts-telemetry-properties-commands/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 data from the device that doesn't match any property or telemetry definitions in the device template.
 

articles/iot-central/core/how-to-connect-devices-x509.md

@@ -3,7 +3,7 @@ title: Connect devices with X.509 certificates in an Azure IoT Central applicati
 description: How to connect devices with X.509 certificates using Node.js device SDK for IoT Central Application
 author: dominicbetts
 ms.author: dobett
-ms.date: 09/13/2022
+ms.date: 10/31/2022
 ms.topic: how-to
 ms.service: iot-central
 services: iot-central
@@ -111,7 +111,7 @@ Make a note of the location of these files. You need it later.
 
 1. The status of the primary certificate is now **Verified**:
 
-    ![Verified Certificate](./media/how-to-connect-devices-x509/verified.png)
+    :::image type="content" source="media/how-to-connect-devices-x509/verified.png" alt-text="Screenshot that shows a verified X509 certificate." lightbox="media/how-to-connect-devices-x509/verified.png":::
 
 You can now connect devices that have an X.509 certificate derived from this primary root certificate.
 
@@ -206,7 +206,7 @@ To run the sample:
 
 Verify that telemetry appears on the device view in your IoT Central application:
 
-![Screenshot that shows telemetry arriving in your IoT Central application.](./media/how-to-connect-devices-x509/telemetry.png)
+:::image type="content" source="media/how-to-connect-devices-x509/telemetry.png" alt-text="Screenshot showing telemetry from a device that connected using X.509." lightbox="media/how-to-connect-devices-x509/telemetry.png":::
 
 ## Use individual enrollment
 
@@ -257,7 +257,7 @@ These commands produce the following device certificates:
 
 1. The device now has an individual enrollment with X.509 certificates.
 
-    ![Individual enrollment certificates](./media/how-to-connect-devices-x509/individual-enrollment.png)
+    :::image type="content" source="media/how-to-connect-devices-x509/individual-enrollment.png" alt-text="Screenshot that shows how to connect a device using an X.509 individual enrollment." lightbox="media/how-to-connect-devices-x509/individual-enrollment.png":::
 
 ### Run a sample individual enrollment device
 

articles/iot-central/core/howto-connect-rigado-cascade-500.md

@@ -7,7 +7,7 @@ ms.topic: how-to
 ms.custom: [iot-storeAnalytics-conditionMonitor, iot-p0-scenario]
 author: dominicbetts
 ms.author: dobett
-ms.date: 06/15/2022
+ms.date: 11/01/2022
 
 # This article applies to solution builders.
 ---
@@ -40,11 +40,11 @@ To add a Cascade 500 device template:
 
 1. The page gives you an option to **Create a custom template** or **Use a preconfigured device template**.
 
-1. Select the C500 device template from the list of preconfigured device templates.
+1. Select the Cascade-500 device template from the list of featured device templates.
 
-1. Select **Next: Customize** to continue to the next step.
+1. Select **Next: Review** to continue to the next step.
 
-1. On the next screen, select **Create** to onboard the C500 device template into your IoT Central application.
+1. On the next screen, select **Create** to onboard the Cascade-500 device template into your IoT Central application.
 
 ## Retrieve application connection details
 
@@ -54,11 +54,11 @@ To connect the Cascade 500 device to your IoT Central application, you need to r
 
 1. Make a note of the **ID Scope** for your IoT Central application:
 
-    ![App ID Scope](./media/howto-connect-rigado-cascade-500/app-scope-id.png)
+    :::image type="content" source="media/howto-connect-rigado-cascade-500/app-scope-id.png" alt-text="Screenshot that shows the ID scope for your application." lightbox="media/howto-connect-rigado-cascade-500/app-scope-id.png":::
 
 1. Now select **SAS-IoT-Edge-Devices** and make a note of the **Primary key**:
 
-    ![Primary Key](./media/howto-connect-rigado-cascade-500/primary-key-sas.png)  
+    :::image type="content" source="media/howto-connect-rigado-cascade-500/primary-key-sas.png" alt-text="Screenshot that shows the primary SAS key for you device connection group." lightbox="media/howto-connect-rigado-cascade-500/primary-key-sas.png":::
 
 ## Contact Rigado to connect the gateway
 
@@ -68,9 +68,9 @@ When the device connects to the internet, Rigado can push down a configuration u
 
 This update applies the IoT Central connection details on the Cascade 500 device and it then appears in your devices list:
 
-![Devices list](./media/howto-connect-rigado-cascade-500/devices-list-c500.png)  
+:::image type="content" source="media/howto-connect-rigado-cascade-500/devices-list-c500.png" alt-text="Screenshot that shows a Cascade-500 device connection to your application." lightbox="media/howto-connect-rigado-cascade-500/devices-list-c500.png":::
 
-You're now ready to use your C500 device in your IoT Central application.
+You're now ready to use your Cascade-500 device in your IoT Central application.
 
 ## Next steps
 

articles/iot-central/core/howto-connect-ruuvi.md

@@ -7,7 +7,7 @@ ms.topic: how-to
 ms.custom: [iot-storeAnalytics-conditionMonitor, iot-p0-scenario]
 ms.author: avneets
 author: avneet723
-ms.date: 08/20/2021
+ms.date: 11/01/2022
 
 # This article applies to solution builders.
 ---
@@ -56,7 +56,7 @@ To connect the RuuviTag with your IoT Central application, you need to set up a
 
 1. In a few seconds, your RuuviTag appears in the list of devices within IoT Central:
 
-    ![RuuviTag Device List](./media/howto-connect-ruuvi/ruuvi-device-list.png)
+    :::image type="content" source="media/howto-connect-ruuvi/ruuvi-device-list.png" alt-text="Screenshot that shows the device list with a RuuviTag." lightbox="media/howto-connect-ruuvi/ruuvi-device-list.png":::
 
 You can now use this RuuviTag device within your IoT Central application.  
 

articles/iot-central/core/howto-create-analytics.md

@@ -3,7 +3,7 @@ title: Analyze device data in your Azure IoT Central application | Microsoft Doc
 description: Analyze device data in your Azure IoT Central application.
 author: dominicbetts
 ms.author: dobett
-ms.date: 06/21/2022
+ms.date: 11/03/2022
 ms.topic: how-to
 ms.service: iot-central
 services: iot-central
@@ -34,7 +34,7 @@ The analytics user interface has three main components:
 
 - **Chart control:** The chart control visualizes the data as a line chart. You can toggle the visibility of specific lines by interacting with the chart legend.
 
-  :::image type="content" source="media/howto-create-analytics/analytics-ui.png" alt-text="Screenshot that shows the three areas of the data explorer UI.":::
+  :::image type="content" source="media/howto-create-analytics/analytics-ui.png" alt-text="Screenshot that shows the three areas of the data explorer UI." lightbox="media/howto-create-analytics/analytics-ui.png":::
 
 ## Query your data
 
@@ -60,7 +60,7 @@ Select **Save** to save an analytics query. Later, you can retrieve any queries
 
 - **Time editor panel:** By default you see data from the last day. You can drag either end of the slider to change the time duration. You can also use the calendar control to select one of the predefined time buckets or select a custom time range. The time control also has an **Interval size** slider that controls the interval size used to aggregate the data.
 
-  :::image type="content" source="media/howto-create-analytics/time-editor-panel.png" alt-text="Screenshot that shows the time editor panel.":::
+  :::image type="content" source="media/howto-create-analytics/time-editor-panel.png" alt-text="Screenshot that shows the time editor panel." lightbox="media/howto-create-analytics/time-editor-panel.png":::
 
   - **Inner date range slider tool**: Use the two endpoint controls to highlight the time span you want. The inner date range is constrained by the outer date range slider control.
 
@@ -83,11 +83,11 @@ Select **Save** to save an analytics query. Later, you can retrieve any queries
   - **Shared:** A graph for each telemetry type is plotted against the same y-axis.
   - **Overlap:** Use this mode to stack multiple lines on the same y-axis, with the y-axis data changing based on the selected line.
 
-  :::image type="content" source="media/howto-create-analytics/y-axis-control.png" alt-text="A screenshot that highlights the y-axis control.":::
+  :::image type="content" source="media/howto-create-analytics/y-axis-control.png" alt-text="A screenshot that highlights the y-axis control." lightbox="media/howto-create-analytics/y-axis-control.png":::
 
 - **Zoom control:** The zoom control lets you drill further into your data. If you find a time period you'd like to focus on within your result set, use your mouse pointer to highlight the area. Then  select **Zoom in**.
 
-  :::image type="content" source="media/howto-create-analytics/zoom.png" alt-text="A Screenshot that shows the use of the zoom control.":::
+  :::image type="content" source="media/howto-create-analytics/zoom.png" alt-text="A Screenshot that shows the use of the zoom control." lightbox="media/howto-create-analytics/zoom.png":::
 
 Select the ellipsis, for more chart controls:
 
@@ -97,7 +97,7 @@ Select the ellipsis, for more chart controls:
 
 - **Drop a Marker:** The **Drop Marker** control lets you anchor certain data points on the chart. It's useful when you're trying to compare data for multiple lines across different time periods.
 
-  :::image type="content" source="media/howto-create-analytics/additional-chart-controls.png" alt-text="A Screenshot that shows how to access the additional chart controls.":::
+  :::image type="content" source="media/howto-create-analytics/additional-chart-controls.png" alt-text="A Screenshot that shows how to access the additional chart controls." lightbox="media/howto-create-analytics/additional-chart-controls.png":::
 
 ## Next steps
 

articles/iot-central/core/howto-create-iot-central-application.md

@@ -5,7 +5,7 @@ services: iot-central
 ms.service: iot-central
 author: dominicbetts
 ms.author: dobett
-ms.date: 06/20/2022
+ms.date: 10/28/2022
 ms.topic: how-to
 ---
 
@@ -77,22 +77,20 @@ The **My apps** page lists all the IoT Central applications you have access to.
 
 You can create a copy of any application, minus any device instances, device data history, and user data. The copy uses a standard pricing plan that you'll be billed for.
 
-Select **Copy**. In the dialog box, enter the details for the new application. Then select **Copy** to confirm that you want to continue. To learn more about the fields in the form, see [Create an application](howto-create-iot-central-application.md).
+Navigate to **Application > Management** and select **Copy**. In the dialog box, enter the details for the new application. Then select **Copy** to confirm that you want to continue. To learn more about the fields in the form, see [Create an application](howto-create-iot-central-application.md).
 
-:::image type="content" source="media/howto-create-iot-central-application/app-copy-1.png" alt-text="Screenshot of that shows application management page.":::
+:::image type="content" source="media/howto-create-iot-central-application/app-copy.png" alt-text="Screenshot that shows the copy application settings page." lightbox="media/howto-create-iot-central-application/app-copy.png":::
 
-:::image type="content" source="media/howto-create-iot-central-application/app-copy-2.png" alt-text="Screenshot that shows the Copy Application settings page.":::
+After the application copy operation succeeds, you can navigate to the new application using the link.
 
-After the app copy operation succeeds, you can navigate to the new application using the link.
-
-Copying an application also copies the definition of rules and email action. Some actions, such as Flow and  Logic Apps, are tied to specific rules via the Rule ID. When a rule is copied to a different application, it gets its own Rule ID. In this case, users will have to create a new action and then associate the new rule with it. In general, it's a good idea to check the rules and actions to make sure they're up-to-date in the new app.
+Copying an application also copies the definition of rules and email action. Some actions, such as Flow and Logic Apps, are tied to specific rules by the rule ID. When a rule is copied to a different application, it gets its own rule ID. In this case, users must create a new action and then associate the new rule with it. In general, it's a good idea to check the rules and actions to make sure they're up-to-date in the new application.
 
 > [!WARNING]
 > If a dashboard includes tiles that display information about specific devices, then those tiles show **The requested resource was not found** in the new application. You must reconfigure these tiles to display information about devices in your new application.
 
 ## Create and use a custom application template
 
-When you create an Azure IoT Central application, you have a choice of built-in sample templates. You can also create your own application templates from existing IoT Central applications. You can then use your own application templates when you create new applications.
+When you create an Azure IoT Central application, you choose from the built-in sample templates. You can also create your own application templates from existing IoT Central applications. You can then use your own application templates when you create new applications.
 
 When you create an application template, it includes the following items from your existing application:
 
@@ -119,8 +117,7 @@ To create an application template from an existing IoT Central application:
 1. On the **Template Export** page, enter a name and description for your template.
 1. Select the **Export** button to create the application template. You can now copy the **Shareable Link** that enables someone to create a new application from the template:
 
-
-:::image type="content" source="media/howto-create-iot-central-application/create-template-2.png" alt-text="Screenshot that shows export an application template.":::
+:::image type="content" source="media/howto-create-iot-central-application/create-template.png" alt-text="Screenshot that shows export an application template." lightbox="media/howto-create-iot-central-application/create-template.png":::
 
 ### Use an application template
 

articles/iot-central/core/howto-edit-device-template.md

@@ -3,7 +3,7 @@ title: Edit a device template in your Azure IoT Central application | Microsoft
 description: Iterate over your device templates without impacting your live connected devices
 author: dominicbetts
 ms.author: dobett
-ms.date: 06/22/2022
+ms.date: 10/31/2022
 ms.topic: how-to
 ms.service: iot-central
 services: iot-central
@@ -78,7 +78,7 @@ The following snippet shows the device model for a thermostat device. The device
 
 To view this information in the IoT Central UI, select **View identity** in the device template editor:
 
-:::image type="content" source="media/howto-edit-device-template/view-identity.png" alt-text="View the identity of an interface to see the version number":::
+:::image type="content" source="media/howto-edit-device-template/view-identity.png" alt-text="View the identity of an interface to see the version number" lightbox="media/howto-edit-device-template/view-identity.png":::
 
 ## Version a device template
 
@@ -111,7 +111,7 @@ You can create multiple versions of the device template. Over time, you'll have
 1. Select the device you need to migrate to another version.
 1. Choose **Migrate**:
 
-    :::image type="content" source="media/howto-edit-device-template/migrate-device.png" alt-text="Choose the option to start migrating a device":::
+    :::image type="content" source="media/howto-edit-device-template/migrate-device.png" alt-text="Choose the option to start migrating a device" lightbox="media/howto-edit-device-template/migrate-device.png":::
 
 1. Select the device template with the version you want to migrate the device to and select **Migrate**.