Screenshot updates

Author: dominicbetts

articles/iot-central/core/howto-administer.md

@@ -21,19 +21,17 @@ To access and use the **Settings > Application** and **Settings > Customization*
 
 In the **Application > Management** page, you can change the name and URL of your application, then select **Save**.
 
-![Application management page](media/howto-administer/image-a.png)
+:::image type="content" source="media/howto-administer/application-management.png" alt-text="Screenshot that shows how to access the application management page." lightbox="media/howto-administer/application-management.png":::
 
 If your administrator creates a custom theme for your application, this page includes an option to hide the **Application Name** in the UI. This option is useful if the application logo in the custom theme includes the application name. For more information, see [Customize the Azure IoT Central UI](./howto-customize-ui.md).
 
-> [!Note]
-> If you change your URL, your old URL can be taken by another Azure IoT Central customer. If that happens, it is no longer available for you to use. When you change your URL, the old URL no longer works, and you need to notify your users about the new URL to use.
+If you change your URL, your old URL can be taken by another Azure IoT Central customer. If that happens, it is no longer available for you to use. When you change your URL, the old URL no longer works, and you need to notify your users about the new URL to use.
 
 ## Delete an application
 
 Use the **Delete** button to permanently delete your IoT Central application. This action permanently deletes all data that's associated with the application.
 
-> [!Note]
-> To delete an application, you must also have permissions to delete resources in the Azure subscription you chose when you created the application. To learn more, see [Assign Azure roles to manage access to your Azure subscription resources](../../role-based-access-control/role-assignments-portal.md).
+To delete an application, you must also have permissions to delete resources in the Azure subscription you chose when you created the application. To learn more, see [Assign Azure roles to manage access to your Azure subscription resources](../../role-based-access-control/role-assignments-portal.md).
 
 ## Manage programmatically
 

articles/iot-central/core/howto-create-and-manage-applications-csp.md

@@ -31,6 +31,8 @@ You land on the Azure IoT Central Application Manager page. Azure IoT Central ke
 
 ![Create Manager for CSPs](media/howto-create-and-manage-applications-csp/image3.png)
 
+:::image type="content" source="media/howto-create-and-manage-applications-csp/iot-central-landing-page.png" alt-text="Screenshot of the IoT Central application manager page.":::
+
 To create an Azure IoT Central application, select **Build** in the left menu. Choose one of the industry templates, or choose **Custom app** to create an application from scratch. This will load the Application Creation page. You must complete all the fields on this page and then choose **Create**. 
 
 ## Application name

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

@@ -57,7 +57,7 @@ After you define your organization hierarchy, assign your devices to organizatio
 
 When you create a new device in your application, assign it to an organization in your hierarchy:
 
-:::image type="content" source="media/howto-create-organization/assign-device.png" alt-text="Screenshot that shows how to assign a device to an organization.":::
+:::image type="content" source="media/howto-create-organization/assign-device.png" alt-text="Screenshot that shows how to assign a device to an organization." lightbox="media/howto-create-organization/assign-device.png":::
 
 To assign or reassign an existing device to an organization, select the device in the device list and then select **Organization**:
 
@@ -86,27 +86,25 @@ You assign gateway and downstream devices to organizations. You don't have to as
 
 When you create the first organization in your application, IoT Central adds three new roles in your application: **Org Administrator**, **Org Operator**, and **Org Viewer**. These roles are necessary because an organization user can't access certain application-wide capabilities such as pricing plans, branding and colors, API tokens, and application-wide enrollment group information.
 
-:::image type="content" source="media/howto-create-organization/organization-roles.png" alt-text="Screenshot that shows the three organization roles.":::
+:::image type="content" source="media/howto-create-organization/organization-roles.png" alt-text="Screenshot that shows the three organization roles." lightbox="media/howto-create-organization/organization-roles.png":::
 
 You can use these roles when you invite users to an organization in your application.
 
 ### Custom organization roles
 
 To create a custom role for your organization users, create a new role and choose the **Organization** role type:
 
-:::image type="content" source="media/howto-create-organization/custom-organization-role.png" alt-text="Screenshot that shows how to create a custom organization role.":::
+:::image type="content" source="media/howto-create-organization/custom-organization-role.png" alt-text="Screenshot that shows how to create a custom organization role." lightbox="media/howto-create-organization/custom-organization-role.png":::
 
-Then select the permissions for the role:
-
-:::image type="content" source="media/howto-create-organization/organization-role-permissions.png" alt-text="Screenshot that shows how to select custom permissions for an organizational role.":::
+Then select the permissions for the role.
 
 ## Invite users
 
 After you've created your organization hierarchy and assigned devices to organizations, invite users to your application and assign them to organizations.
 
 To invite a user, navigate to **Permissions > Users**. Enter their email address, the organization they're assigned to, and the role or roles the user is a member of. The organization you select filters the list of available roles to make sure you assign the user to a valid role:
 
-:::image type="content" source="media/howto-create-organization/assign-user-organization.png" alt-text="Screenshot that shows how to assign a user to an organization and role.":::
+:::image type="content" source="media/howto-create-organization/assign-user-organization.png" alt-text="Screenshot that shows how to assign a user to an organization and role." lightbox="media/howto-create-organization/assign-user-organization.png":::
 
 You can assign the same user to multiple organizations. The user can have a different role in each organization they're assigned to:
 

articles/iot-central/core/howto-create-private-endpoint.md

@@ -49,7 +49,7 @@ To create a private endpoint on an existing IoT Central application:
 
 1. On the **DNS** tab,  select **Yes** for **Integrate with private DNS zone.** The private DNS resolves all the required endpoints to private IP addresses in your virtual network.
 
-    :::image type="content" source="media/howto-create-private-endpoint/private-dns-integration​.png" alt-text="Screenshot from Azure portal that shows private D N S integration.":::
+    :::image type="content" source="media/howto-create-private-endpoint/private-dns-integration​.png" alt-text="Screenshot from Azure portal that shows private DNS integration.":::
 
     > [!NOTE]
     > Because of the autoscale capabilities in IoT Central, you should use the **Private DNS integration** option if at all possible. If for some reason you can't use this option, see [Use a custom DNS server](#use-a-custom-dns-server).
@@ -156,7 +156,7 @@ When you configure a private endpoint for your IoT Central application, the IoT
 
 Update your device code to use the direct DPS endpoint.
 
-:::image type="content" source="media/howto-create-private-endpoint/direct-dps-endpoint.png" alt-text="Screenshot from I o T Central application that shows the direct D P S endpoint.":::
+:::image type="content" source="media/howto-create-private-endpoint/direct-dps-endpoint.png" alt-text="Screenshot from I o T Central application that shows the direct DPS endpoint." lightbox="media/howto-create-private-endpoint/direct-dps-endpoint.png":::
 
 ## Best practices
 

articles/iot-central/core/howto-customize-ui.md

@@ -18,17 +18,20 @@ This article describes how you can customize the UI of your application by apply
 
 The following screenshot shows a page using the standard theme:
 
-![Standard IoT Central theme](./media/howto-customize-ui/standard-ui.png)
+:::image type="content" source="media/howto-customize-ui/standard-ui.png" alt-text="Screenshot that shows the default UI theme." lightbox="media/howto-customize-ui/standard-ui.png":::
 
 The following screenshot shows a page using a custom screenshot with the customized UI elements highlighted:
 
-![Custom IoT Central theme](./media/howto-customize-ui/themed-ui.png)
+:::image type="content" source="media/howto-customize-ui/themed-ui.png" alt-text="Screenshot that shows a custom UI theme." lightbox="media/howto-customize-ui/themed-ui.png":::
+
+> [!TIP]
+> You can also customize the image shown in browser's address bar and list of favorites.
 
 ## Create theme
 
 To create a custom theme, navigate to the **Appearance** section in the **Customization** page.
 
-![IoT Central themes](./media/howto-customize-ui/themes.png)
+:::image type="content" source="media/howto-customize-ui/themes.png" alt-text="Screenshot that shows the appearance customization page." lightbox="media/howto-customize-ui/themes.png":::
 
 On this page, you can customize the following aspects of your application:
 
@@ -59,11 +62,11 @@ To provide custom help information to your operators and other users, you can mo
 
 To modify the help links, navigate to the **Help links** section in the **Customization** page.
 
-![Customize IoT Central help links](./media/howto-customize-ui/help-links.png)
+:::image type="content" source="media/howto-customize-ui/help-links.png" alt-text="Screenshot that shows how to customize the help links." lightbox="media/howto-customize-ui/help-links.png":::
 
 You can also add new entries to the help menu and remove default entries:
 
-![Customized IoT Central help](./media/howto-customize-ui/custom-help.png)
+:::image type="content" source="media/howto-customize-ui/custom-help.png" alt-text="Screenshot that shows the list of help links." lightbox="media/howto-customize-ui/custom-help.png":::
 
 > [!NOTE]
 > You can always revert back to the default help links on the **Customization** page.
@@ -177,11 +180,11 @@ Following example shows how to change the word `Device` to `Asset` when you view
 
 1. Upload your edited customization file and select **Save** to see your new text in the application:
 
-    :::image type="content" source="media/howto-customize-ui/upload-custom-text.png" alt-text="Screenshot showing how to upload custom text file.":::
+    :::image type="content" source="media/howto-customize-ui/upload-custom-text.png" alt-text="Screenshot showing how to upload a custom text file." lightbox="media/howto-customize-ui/upload-custom-text.png":::
 
     The UI now uses the new text values:
 
-    :::image type="content" source="media/howto-customize-ui/updated-ui-text.png" alt-text="Screenshot that shows updated text in the U I.":::
+    :::image type="content" source="media/howto-customize-ui/updated-ui-text.png" alt-text="Screenshot that shows updated text in the UI." lightbox="media/howto-customize-ui/updated-ui-text.png":::
 
 You can reupload the customization file with further changes by selecting the relevant language from the list on the **Text** section in the **Customization** page.
 

articles/iot-central/core/howto-manage-preferences.md

@@ -7,7 +7,6 @@ ms.date: 06/22/2022
 ms.topic: how-to
 ms.service: iot-central
 services: iot-central
-manager: peterpr
 
 # This article applies to operators, builders, and administrators.
 ---
@@ -23,12 +22,11 @@ IoT Central is supported in multiple languages. You can switch your preferred la
 
 We have support for both dark theme and light theme. While the light theme is the default, you can change the theme by selecting the settings icon on the top navigation bar.
 
-![IoT Central theme picker](media/howto-manage-preferences/settings.png)
+:::image type="content" source="media/howto-manage-preferences/settings.png" alt-text="Screenshot that shows how to access the theme settings." lightbox="media/howto-manage-preferences/settings.png":::
 
 > [!NOTE]
 > The option to choose between light and dark themes isn't available if your administrator has configured a custom theme for the application.
 
 ## Change default organization
 
 If your application uses organizations, you can select a default organization to use whenever you need to select an organization. For example, the default organization pre-populates the organization field when you add a new device to your application.
-

articles/iot-central/core/howto-manage-users-roles.md

@@ -25,7 +25,7 @@ Every user must have a user account before they can sign in and access an applic
 
 1. To add a user to an IoT Central application, go to the **Users** page in the **Permissions** section.
 
-    :::image type="content" source="media/howto-manage-users-roles/manage-users.png" alt-text="Screenshot of manage users page in IoT Central." lightbox="media/howto-manage-users-roles/manage-users.png":::  
+    :::image type="content" source="media/howto-manage-users-roles/manage-users.png" alt-text="Screenshot that shows the manage users page in IoT Central." lightbox="media/howto-manage-users-roles/manage-users.png":::  
 
 1. To add a user on the **Users** page, choose **+ Assign user**. To add a service principal on the **Users** page, choose **+ Assign service principal**. To add an Azure Active Directory group on the **Users** page, choose **+ Assign group**. Start typing the name of the Active Directory group or service principal to auto-populate the form.
 
@@ -36,7 +36,7 @@ Every user must have a user account before they can sign in and access an applic
 
 1. Choose a role for the user from the **Role** drop-down menu. Learn more about roles in the [Manage roles](#manage-roles) section of this article.
 
-    :::image type="content" source="media/howto-manage-users-roles/add-user.png" alt-text="Screenshot to add a user and select a role." lightbox="media/howto-manage-users-roles/add-user.png":::
+    :::image type="content" source="media/howto-manage-users-roles/add-user.png" alt-text="Screenshot showing how to add a user and select a role." lightbox="media/howto-manage-users-roles/add-user.png":::
 
     The available roles depend on the organization the user is associated with. You can assign **App** roles to users associated with the root organization, and **Org** roles to users associated with any other organization in the hierarchy.
 
@@ -69,7 +69,7 @@ To delete users, select one or more check boxes on the **Users** page. Then sele
 
 Roles enable you to control who within your organization is allowed to do various tasks in IoT Central. There are three built-in roles you can assign to users of your application. You can also [create custom roles](#create-a-custom-role) if you require finer-grained control.
 
-:::image type="content" source="media/howto-manage-users-roles/manage-roles.png" alt-text="Screenshot to Manage roles selection." lightbox="media/howto-manage-users-roles/manage-roles.png":::
+:::image type="content" source="media/howto-manage-users-roles/manage-roles.png" alt-text="Screenshot that shows how to manage roles." lightbox="media/howto-manage-users-roles/manage-roles.png":::
 
 ### App Administrator
 

articles/iot-central/core/howto-use-audit-logs.md

@@ -45,29 +45,29 @@ The log stores data for 30 days, after which it's no longer available.
 
 The following screenshot shows the audit log view with the location of the sorting and filtering controls highlighted:
 
-:::image type="content" source="media/howto-use-audit-logs/audit-log.png" alt-text="Screenshot that shows the audit log. The location of the sort and filter controls is highlighted.":::
+:::image type="content" source="media/howto-use-audit-logs/audit-log.png" alt-text="Screenshot that shows the audit log. The location of the sort and filter controls is highlighted." lightbox="media/howto-use-audit-logs/audit-log.png":::
 
 ## Customize the log
 
 Select **Column options** to customize the audit log view. You can add and remove columns, reorder the columns, and change the column widths:
 
-:::image type="content" source="media/howto-use-audit-logs/audit-logs-column-options.png" alt-text="Screenshot that shows the audit log column options.":::
+:::image type="content" source="media/howto-use-audit-logs/audit-logs-column-options.png" alt-text="Screenshot that shows the audit log column options." lightbox="media/howto-use-audit-logs/audit-logs-column-options.png":::
 
 ## Sort the log
 
 You can sort the log into ascending or descending timestamp order. To sort, select **Timestamp**:
 
-:::image type="content" source="media/howto-use-audit-logs/audit-logs-sorting.png" alt-text="Screenshot that shows how to sort the log into descending timestamp order.":::
+:::image type="content" source="media/howto-use-audit-logs/audit-logs-sorting.png" alt-text="Screenshot that shows how to sort the log into descending timestamp order." lightbox="media/howto-use-audit-logs/audit-logs-sorting.png":::
 
 ## Filter the log
 
 To focus on a specific time, filter the log by time range. Select **Edit time range** and specify the range you're interested in:
 
-:::image type="content" source="media/howto-use-audit-logs/audit-logs-time.png" alt-text="Screenshot that shows how filter the log to show the last hour of entries.":::
+:::image type="content" source="media/howto-use-audit-logs/audit-logs-time.png" alt-text="Screenshot that shows how filter the log to show the last hour of entries." lightbox="media/howto-use-audit-logs/audit-logs-time.png":::
 
 To focus on specific entries, filter by entity type or action. Select **Filter** and use the multi-select drop-downs to specify your filter conditions:
 
-:::image type="content" source="media/howto-use-audit-logs/audit-logs-filter.png" alt-text="Screenshot that shows how filter the log to show only updates to user entities.":::
+:::image type="content" source="media/howto-use-audit-logs/audit-logs-filter.png" alt-text="Screenshot that shows how filter the log to show only updates to user entities." lightbox="media/howto-use-audit-logs/audit-logs-filter.png":::
 
 ## Manage access