Merge pull request #152400 from v-lakast/tsi-improvements

Improved clarity, added h2's

Author: jborsecnik

articles/digital-twins/how-to-ingest-iot-hub-data.md

@@ -46,7 +46,7 @@ Whenever a temperature telemetry event is sent by the thermostat device, a funct
 
 In this section, you'll set up a [digital twin](concepts-twins-graph.md) in Azure Digital Twins that will represent the thermostat device and will be updated with information from IoT Hub.
 
-To create a thermostat-type twin, you'll first need to upload the thermostat [model](concepts-models.md) to your instance, which describes the properties of a thermostat and will be used later to create the twin. 
+To create a thermostat-type twin, you'll first need to upload the thermostat [model](concepts-models.md) to your instance, which describes the properties of a thermostat and will be used later to create the twin.
 
 [!INCLUDE [digital-twins-thermostat-model-upload.md](../../includes/digital-twins-thermostat-model-upload.md)]
 

articles/digital-twins/how-to-integrate-time-series-insights.md

@@ -10,4 +10,4 @@ ms.author: baanders
 For instructions on how to do this, see the section [**Publish the function app to Azure**](../articles/digital-twins/how-to-create-azure-function.md#publish-the-function-app-to-azure) of the *How-to: Set up a function for processing data* article.
 
 > [!IMPORTANT]
-> When creating the function app for the first time in the [Prerequisites](#prerequisites) section, you may have already assigned an access role for the function and configured the application settings for it to access your Azure Digital Twins instance. These need to be done once for the entire function app, so verify they've been completed in your app before continuing. You can find instructions in the [**Set up security access for the function app**](../articles/digital-twins/how-to-create-azure-function.md#set-up-security-access-for-the-function-app) of the *How to: Ingest IoT hub data article.*
+> When creating the function app for the first time in the [Prerequisites](#prerequisites) section, you may have already assigned an access role for the function and configured the application settings for it to access your Azure Digital Twins instance. These need to be done once for the entire function app, so verify they've been completed in your app before continuing. You can find instructions in the [**Set up security access for the function app**](../articles/digital-twins/how-to-create-azure-function.md#set-up-security-access-for-the-function-app) section of the *How to: Ingest IoT hub data article.*

articles/digital-twins/media/how-to-integrate-time-series-insights/create-event-hub-trigger-function.png

@@ -3,23 +3,15 @@ author: baanders
 description: include file to upload a model to Azure Digital Twins instance
 ms.service: digital-twins
 ms.topic: include
-ms.date: 3/23/2021
+ms.date: 4/1/2021
 ms.author: baanders
 ---
 
 The model looks like this:
 :::code language="json" source="~/digital-twins-docs-samples/models/Thermostat.json":::
 
-To **upload this model to your twins instance**, run the following Azure CLI command, which uploads the above model as inline JSON. You can run the command in [Azure Cloud Shell](../articles/cloud-shell/overview.md) in your browser, or on your machine if you have the CLI [installed locally](/cli/azure/install-azure-cli).
+To **upload this model to your twins instance**, run the following Azure CLI command, which uploads the above model as inline JSON. You can run the command in [Azure Cloud Shell](../articles/cloud-shell/overview.md) in your browser (use the **Bash** environment), or on your machine if you have the CLI [installed locally](/cli/azure/install-azure-cli).
 
 ```azurecli-interactive
 az dt model create --models '{  "@id": "dtmi:contosocom:DigitalTwins:Thermostat;1",  "@type": "Interface",  "@context": "dtmi:dtdl:context;2",  "contents": [    {      "@type": "Property",      "name": "Temperature",      "schema": "double"    }  ]}' -n {digital_twins_instance_name}
-```
-
-> [!Note]
-> If you are using Cloud Shell in the PowerShell environment, you may need to escape the quotation mark characters on the inline JSON fields for their values to be parsed correctly. Here is the command to upload the model with this modification:
->
-> Upload model:
-> ```azurecli-interactive
-> az dt model create --models '{  \"@id\": \"dtmi:contosocom:DigitalTwins:Thermostat;1\",  \"@type\": \"Interface\",  \"@context\": \"dtmi:dtdl:context;2\",  \"contents\": [    {      \"@type\": \"Property\",      \"name\": \"Temperature\",      \"schema\": \"double\"    }  ]}' -n {digital_twins_instance_name}
-> ```
+```

articles/digital-twins/media/how-to-integrate-time-series-insights/create-time-series-insights-environment-1.png

@@ -12,6 +12,6 @@ This article highlights how to complete different management operations using th
 > [!TIP] 
 > Remember that all SDK methods come in synchronous and asynchronous versions. For paging calls, the async methods return `AsyncPageable<T>` while the synchronous versions return `Pageable<T>`.
 
-Another management option is to call the the Azure Digital Twins [**REST APIs**](/rest/api/azure-digitaltwins/) for this topic area directly, through a REST client like Postman. For instructions on how to do this, see [*How-to: Make requests with Postman*](../articles/digital-twins/how-to-use-postman.md).
+Another management option is to call the Azure Digital Twins [**REST APIs**](/rest/api/azure-digitaltwins/) for this topic area directly, through a REST client like Postman. For instructions on how to do this, see [*How-to: Make requests with Postman*](../articles/digital-twins/how-to-use-postman.md).
 
 Finally, you can complete the same management operations using the Azure Digital Twins **CLI**. To learn more about using the CLI, see [*How-to: Use the Azure Digital Twins CLI*](../articles/digital-twins/how-to-use-cli.md).