updated text formatting in the include files

Author: v-gweinstock

articles/digital-twins/how-to-ingest-opcua-data.md

@@ -294,7 +294,7 @@ First, deploy a new Azure Digital Twins instance, using the guidance in [Set up
 
 Next, add a model and twin to your instance. The model file that you'll upload to the instance is part of the sample project you downloaded in the [Prerequisites](#prerequisites) section, located at *Simulation Example/simulation-dtdl-model.json*.
 
-You can use [Azure Digital Twins Explorer](concepts-azure-digital-twins-explorer.md) to upload the Simulation model, and create a new twin called *simulation-1*.
+You can use [Azure Digital Twins Explorer](concepts-azure-digital-twins-explorer.md) to upload the Simulation model, and create a new twin called simulation-1.
 
 :::image type="content" source="media/how-to-ingest-opcua-data/azure-digital-twins-explorer.png" alt-text="Screenshot of Azure Digital Twins Explorer, showing the Simulation model and simulation-1 twin.":::
 

includes/digital-twins-access-explorer.md

@@ -15,8 +15,8 @@ This will open Azure Digital Twins Explorer in a new tab. It may already be conn
 
 :::image type="content" source="../articles/digital-twins/media/includes/azure-digital-twins-explorer-no-environment.png" alt-text="Screenshot of Azure Digital Twins Explorer. The Azure Digital Twins URL modal displays an empty editable box for the Azure Digital Twins URL." lightbox="../articles/digital-twins/media/includes/azure-digital-twins-explorer-no-environment.png":::
 
-If you see this modal, enter _**https://**_ into the box, followed by the **host name** of your instance. These values together make up the instance URL. Select Save to connect to the instance.
+If you see this modal, enter *https://* into the box, followed by the host name of your instance. These values together make up the instance URL. Select **Save** to connect to the instance.
 
 >[!TIP]
->You can find the **host name** of your instance in its Overview page in the portal.
+>You can find the host name of your instance in its **Overview** page in the portal.
 > :::image type="content" source="../articles/digital-twins/media/includes/portal-host-name.png" alt-text="Screenshot of the Azure portal showing the Overview page for an Azure Digital Twins instance. There's a highlight around the Host name value." lightbox="../articles/digital-twins/media/includes/portal-host-name.png":::

includes/digital-twins-cleanup-basic.md

@@ -7,7 +7,7 @@ ms.date: 2/4/2021
 ms.author: baanders
 ---
 
-* **If you do not need any of the resources you created in this tutorial**, you can delete the Azure Digital Twins instance and all other resources from this article with the [az group delete](/cli/azure/group#az_group_delete) CLI command. This deletes all Azure resources in a resource group, as well as the resource group itself.
+* If you do not need any of the resources you created in this tutorial, you can delete the Azure Digital Twins instance and all other resources from this article with the [az group delete](/cli/azure/group#az_group_delete) CLI command. This deletes all Azure resources in a resource group, as well as the resource group itself.
 
     > [!IMPORTANT]
     > Deleting a resource group is irreversible. The resource group and all the resources contained in it are permanently deleted. Make sure that you don't accidentally delete the wrong resource group or resources.

includes/digital-twins-cleanup-clear-instance.md

@@ -7,4 +7,4 @@ ms.date: 2/4/2021
 ms.author: baanders
 ---
 
-* **If you want to continue using the Azure Digital Twins instance you set up in this article, but clear out some or all of its models, twins, and relationships**, you can use the [az dt](/cli/azure/dt) CLI commands in an [Azure Cloud Shell](https://shell.azure.com) window to delete the elements you want to remove.
+* If you want to continue using the Azure Digital Twins instance you set up in this article, but clear out some or all of its models, twins, and relationships, you can use the [az dt](/cli/azure/dt) CLI commands in an [Azure Cloud Shell](https://shell.azure.com) window to delete the elements you want to remove.

includes/digital-twins-configure-function-app-cli.md

@@ -38,7 +38,7 @@ The Azure function requires a bearer token to be passed to it. To make sure the
 
 #### Configure application settings
 
-Next, make the URL of your **Azure Digital Twins instance** accessible to your function by setting an [environment variable](../articles/azure-functions/functions-how-to-use-azure-function-app-settings.md?tabs=portal#use-application-settings) for it.
+Next, make the URL of your Azure Digital Twins instance accessible to your function by setting an [environment variable](../articles/azure-functions/functions-how-to-use-azure-function-app-settings.md?tabs=portal#use-application-settings) for it.
 
 > [!TIP]
 > The Azure Digital Twins instance's URL is made by adding *https://* to the beginning of your instance's host name. To see the host name, along with all the properties of your instance, run `az dt show --dt-name <your-Azure-Digital-Twins-instance>`.

includes/digital-twins-configure-function-app.md

@@ -29,26 +29,26 @@ The lifecycle of this type of managed identity is tied to the lifecycle of this
 
     :::image type="content" source="../articles/digital-twins/media/includes/azure-functions/portal-search-for-function-app.png" alt-text="Screenshot of the Azure portal. The function app's name is in the portal search bar, and the search result is highlighted.":::
 
-1. On the function app page, in the menu on the left, select __Identity__ to work with a managed identity for the function. On the __System assigned__ page, verify that the __Status__ is set to **On**. If it's not, set it now and then **Save** the change.
+1. On the function app page, in the menu on the left, select **Identity** to work with a managed identity for the function. On the **System assigned** page, verify that the **Status** is set to **On**. If it's not, set it now and then **Save** the change.
 
     :::image type="content" source="../articles/digital-twins/media/includes/azure-functions/verify-system-managed-identity.png" alt-text="Screenshot of the Azure portal. On the Identity page for the function app, the Status option is set to On." lightbox="../articles/digital-twins/media/includes/azure-functions/verify-system-managed-identity.png":::
 
-1. Select __Azure role assignments__.
+1. Select **Azure role assignments**.
 
     :::image type="content" source="../articles/digital-twins/media/includes/azure-functions/add-role-assignment-1.png" alt-text="Screenshot of the Azure portal. On the Azure Function's Identity page, under Permissions, the button Azure role assignments is highlighted." lightbox="../articles/digital-twins/media/includes/azure-functions/add-role-assignment-1.png":::
 
-    Select __+ Add role assignment (Preview)__.
+    Select **+ Add role assignment (Preview)**.
 
     :::image type="content" source="../articles/digital-twins/media/includes/azure-functions/add-role-assignment-2.png" alt-text="Screenshot of the Azure portal. On the Azure role assignments page, the button Add role assignment (Preview) is highlighted." lightbox="../articles/digital-twins/media/includes/azure-functions/add-role-assignment-2.png":::
 
-1. On the __Add role assignment (Preview)__ page, select the following values:
+1. On the **Add role assignment (Preview)** page, select the following values:
 
-    * **Scope**: _Resource group_
+    * **Scope**: **Resource group**
     * **Subscription**: Select your Azure subscription.
     * **Resource group**: Select your resource group.
-    * **Role**: _Azure Digital Twins Data Owner_
+    * **Role**: **Azure Digital Twins Data Owner**
 
-    Save the details by selecting __Save__.
+    Save the details by selecting **Save**.
 
     :::image type="content" source="../articles/digital-twins/media/includes/azure-functions/add-role-assignment-3.png" alt-text="Screenshot of the Azure portal, showing how to add a new role assignment. The dialog shows fields for Scope, Subscription, Resource group, and Role.":::
 
@@ -59,8 +59,8 @@ To make the URL of your Azure Digital Twins instance accessible to your function
 To set an environment variable with the URL of your instance, first find your instance's host name: 
 
 1. Search for your instance in the [Azure portal](https://portal.azure.com). 
-1. In the menu on the left, select __Overview__. 
-1. Copy the __Host name__ value.
+1. In the menu on the left, select **Overview**. 
+1. Copy the **Host name** value.
 
     :::image type="content" source="../articles/digital-twins/media/includes/azure-functions/instance-host-name.png" alt-text="Screenshot of the Azure portal. On the instance's Overview page, the host name value is highlighted.":::
 
@@ -70,23 +70,23 @@ You can now create an application setting:
 
     :::image type="content" source="../articles/digital-twins/media/includes/azure-functions/portal-search-for-function-app.png" alt-text="Screenshot of the Azure portal. The function app's name is being searched in the portal search bar. The search result is highlighted.":::
 
-1. On the left, select __Configuration__. Then on the __Application settings__ tab, select __+ New application setting__.
+1. On the left, select **Configuration**. Then on the **Application settings** tab, select **+ New application setting**.
 
     :::image type="content" source="../articles/digital-twins/media/includes/azure-functions/application-setting.png" alt-text="Screenshot of the Azure portal. On the Configuration tab for the function app, the button to create a New application setting is highlighted.":::
 
 1. In the window that opens, use the host name value you copied to create an application setting.
     * **Name**: `ADT_SERVICE_URL`
     * **Value**: `https://<your-Azure-Digital-Twins-host-name>`
 
-    Select __OK__ to create an application setting.
+    Select **OK** to create an application setting.
 
     :::image type="content" source="../articles/digital-twins/media/includes/azure-functions/add-application-setting.png" alt-text="Screenshot of the Azure portal. On the Add/Edit application setting page, the Name and Value fields are filled out. The O K button is highlighted.":::
 
-1. After you create the setting, it should appear on the __Application settings__ tab. Verify that **ADT_SERVICE_URL** appears on the list. Then save the new application setting by selecting __Save__.
+1. After you create the setting, it should appear on the **Application settings** tab. Verify that **ADT_SERVICE_URL** appears on the list. Then save the new application setting by selecting **Save**.
 
     :::image type="content" source="../articles/digital-twins/media/includes/azure-functions/application-setting-save-details.png" alt-text="Screenshot of the Azure portal. On the application settings tab, the new A D T SERVICE URL setting and the Save button are both highlighted.":::
 
-1. Any changes to the application settings require an application restart, so select __Continue__ to restart your application when prompted.
+1. Any changes to the application settings require an application restart, so select **Continue** to restart your application when prompted.
 
     :::image type="content" source="../articles/digital-twins/media/includes/azure-functions/save-application-setting.png" alt-text="Screenshot of the Azure portal. A note states that any changes to application settings will restart your application.":::
 

includes/digital-twins-limits.md

@@ -45,8 +45,8 @@ The following table reflects the rate limits of different APIs.
 | Models API | Number of requests per second | 100 | Yes |
 | Digital Twins API | Number of read requests per second | 1,000 | Yes |
 | Digital Twins API | Number of patch requests per second | 1,000 | Yes |
-| Digital Twins API | Number of create/delete operations per second across **all twins and relationships** | 50 | Yes |
-| Digital Twins API | Number of create/update/delete operations per second on a **single twin** or its incoming/outgoing relationships | 10 | No |
+| Digital Twins API | Number of create/delete operations per second across all twins and relationships | 50 | Yes |
+| Digital Twins API | Number of create/update/delete operations per second on a single twin or its incoming/outgoing relationships | 10 | No |
 | Query API | Number of requests per second | 500 | Yes |
 | Query API | [Query Units](../articles/digital-twins/concepts-query-units.md) per second | 4,000 | Yes |
 | Event Routes API | Number of requests per second | 100 | Yes |

includes/digital-twins-permissions-required.md

@@ -8,4 +8,4 @@ ms.author: baanders
 ---
 
 >[!NOTE]
-> This section must be completed by an Azure user who has permissions to manage user access to Azure resources, including granting and delegating permissions. Common roles that meet this requirement are *Owner*, *Account admin*, or the combination of *User Access Administrator* and *Contributor*. For more information about permission requirements for Azure Digital Twins roles, see [Set up an instance and authentication](../articles/digital-twins/how-to-set-up-instance-portal.md#prerequisites-permission-requirements).
+> This section must be completed by an Azure user who has permissions to manage user access to Azure resources, including granting and delegating permissions. Common roles that meet this requirement are **Owner**, **Account admin**, or the combination of **User Access Administrator** and **Contributor**. For more information about permission requirements for Azure Digital Twins roles, see [Set up an instance and authentication](../articles/digital-twins/how-to-set-up-instance-portal.md#prerequisites-permission-requirements).

includes/digital-twins-prereq-instance.md

@@ -7,10 +7,10 @@ ms.date: 10/29/2020
 ms.author: baanders
 ---
 
-To work with Azure Digital Twins in this article, you first need to *set up an Azure Digital Twins instance*. You also need the required permissions for using it. If you already have an Azure Digital Twins instance set up, you can use it instead.
+To work with Azure Digital Twins in this article, you first need to set up an Azure Digital Twins instance. You also need the required permissions for using it. If you already have an Azure Digital Twins instance set up, you can use it instead.
 
 Otherwise, follow the instructions in [Set up an instance and authentication](../articles/digital-twins/how-to-set-up-instance-portal.md). The instructions contain information to help you verify that you've completed each step successfully.
 
 After you set up your instance, make a note of the following values. You'll need these values to connect to the instance later:
-* The instance's *host name*. You can [find the host name in the Azure portal](../articles/digital-twins/how-to-set-up-instance-portal.md#verify-success-and-collect-important-values).
-* The *Azure subscription* that you used to create the instance. Either its name or its ID will work. You can find the subscription on your instance's **Overview** page in the [Azure portal](https://portal.azure.com).
+* The instance's host name. You can [find the host name in the Azure portal](../articles/digital-twins/how-to-set-up-instance-portal.md#verify-success-and-collect-important-values).
+* The Azure subscription that you used to create the instance. Either its name or its ID will work. You can find the subscription on your instance's **Overview** page in the [Azure portal](https://portal.azure.com).

includes/digital-twins-prereq-registration.md

@@ -7,6 +7,6 @@ ms.date: 10/29/2020
 ms.author: baanders
 ---
 
-To authenticate all the resources used in this article, you'll need to **set up an [Azure Active Directory (Azure AD)](../articles/active-directory/fundamentals/active-directory-whatis.md) app registration**. Follow the instructions in [Create an app registration with Azure Digital Twins access](../articles/digital-twins/how-to-create-app-registration-portal.md) to set this up. 
+To authenticate all the resources used in this article, you'll need to set up an [Azure Active Directory (Azure AD)](../articles/active-directory/fundamentals/active-directory-whatis.md) app registration. Follow the instructions in [Create an app registration with Azure Digital Twins access](../articles/digital-twins/how-to-create-app-registration-portal.md) to set this up. 
 
 Once you have an app registration, you'll need the registration's **Application (client) ID**, **Directory (tenant) ID**, and **client secret** ([find in the Azure portal](../articles/digital-twins/how-to-create-app-registration-portal.md#collect-important-values)). Take note of these values to use them later to grant access to the Azure Digital Twins APIs.