Merge pull request #212549 from baanders/9-26-e2e

ADT: Updates to E2E tutorial

Author: v-stsavell

articles/digital-twins/tutorial-end-to-end.md

@@ -5,7 +5,7 @@ titleSuffix: Azure Digital Twins
 description: Follow this tutorial to learn how to build out an end-to-end Azure Digital Twins solution that's driven by device data.
 author: baanders
 ms.author: baanders # Microsoft employees only
-ms.date: 06/21/2022
+ms.date: 09/26/2022
 ms.topic: tutorial
 ms.service: digital-twins
 
@@ -126,7 +126,7 @@ To publish the function app to Azure, you'll need to create a storage account, t
 
         This command publishes the project to the *digital-twins-samples-main\AdtSampleApp\SampleFunctionsApp\bin\Release\netcoreapp3.1\publish* directory.
 
-    1. Create a zip of the published files that are located in the *digital-twins-samples-main\AdtSampleApp\SampleFunctionsApp\bin\Release\netcoreapp3.1\publish* directory. Name the zipped folder *publish.zip*.
+    1. Using your preferred method, create a zip of the published files that are located in the *digital-twins-samples-main\AdtSampleApp\SampleFunctionsApp\bin\Release\netcoreapp3.1\publish* directory. Name the zipped folder *publish.zip*.
         
         >[!TIP] 
         >If you're using PowerShell, you can create the zip by copying the full path to that *\publish* directory and pasting it into the following command:
@@ -184,21 +184,12 @@ There are two settings that need to be set for the function app to access your A
 
 The first setting gives the function app the **Azure Digital Twins Data Owner** role in the Azure Digital Twins instance. This role is required for any user or function that wants to perform many data plane activities on the instance. You can read more about security and role assignments in [Security for Azure Digital Twins solutions](concepts-security.md). 
 
-1. Use the following command to see the details of the system-managed identity for the function. Take note of the **principalId** field in the output.
+1. Use the following command to create a system-managed identity for the function. The output will display details of the identity that's been created. Take note of the **principalId** field in the output to use in the next step.
 
     ```azurecli-interactive	
-    az functionapp identity show --resource-group <your-resource-group> --name <your-function-app-name>	
+    az functionapp identity assign --resource-group <your-resource-group> --name <your-function-app-name>
     ```
 
-    >[!NOTE]
-    > If the result is empty instead of showing details of an identity, create a new system-managed identity for the function using this command:
-    > 
-    >```azurecli-interactive	
-    >az functionapp identity assign --resource-group <your-resource-group> --name <your-function-app-name>	
-    >```
-    >
-    > The output will then display details of the identity, including the **principalId** value required for the next step. 
-
 1. Use the **principalId** value in the following command to assign the function app's identity to the **Azure Digital Twins Data Owner** role for your Azure Digital Twins instance.
 
     ```azurecli-interactive	
@@ -307,7 +298,7 @@ deviceConnectionString = <your-device-connection-string>
 
 Save the file.
 
-Now, to see the results of the data simulation that you've set up, navigate to *digital-twins-samples-main\DeviceSimulator\DeviceSimulator* in a local console window.
+Now, to see the results of the data simulation that you've set up, open a new local console window and navigate to *digital-twins-samples-main\DeviceSimulator\DeviceSimulator*.
 
 >[!NOTE]
 > You should now have two open console windows: one that's open to the the *DeviceSimulator\DeviceSimulator* folder, and one from earlier that's still open to the *AdtSampleApp\SampleClientApp* folder.

includes/digital-twins-tutorial-sample-prereqs.md

@@ -1,19 +1,21 @@
 ---
 author: baanders
-description: include file for Azure Digital Twins tutorials - prerequisites for the sample project
+description: prerequisites for Azure Digital Twins tutorials
 ms.service: digital-twins
 ms.topic: include
-ms.date: 6/22/2022
+ms.date: 9/26/2022
 ms.author: baanders
 ---
 
 ## Prerequisites
 
-Before beginning this tutorial, start by completing the prerequisites in this section.
+Before beginning this tutorial, start with these prerequisites:
+* If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
+* This tutorial uses .NET Core 3.1. You can download this version of the .NET Core SDK for multiple platforms from [Download .NET Core 3.1](https://dotnet.microsoft.com/download/dotnet-core/3.1).
 
-If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
+Then, continue through the rest of this section to set up the remaining prerequisites.
 
-### Get required resources
+### Get sample resources
 
 The tutorial is driven by an [Azure Digital Twins end-to-end sample project written in C#](/samples/azure-samples/digital-twins-samples/digital-twins-samples). Get the sample project on your machine by navigating to the sample link, and selecting the **Browse code** button underneath the title.