corrections and a few more

KingdomOfEnds · KingdomOfEnds · commit 83eec9fbfe74 · 2020-01-08T15:29:16.000-08:00
diff --git a/articles/digital-twins/concepts-events-routing.md b/articles/digital-twins/concepts-events-routing.md
@@ -48,7 +48,7 @@ Azure Digital Twins currently supports the following **EventTypes** that will be
 
 > [!IMPORTANT]  
 > Not all **EndpointTypes** support all **EventTypes**.
-> Read the following table for the **EventTypes** that are allowed for each **EndpointType**.
+> Review the following table for the **EventTypes** that are allowed for each **EndpointType**.
 
 |             | DeviceMessages | TopologyOperation | SpaceChange | SensorChange | UdfCustom |
 | ----------- | -------------- | ----------------- | ----------- | ------------ | --------- |
diff --git a/articles/digital-twins/how-to-configure-monitoring.md b/articles/digital-twins/how-to-configure-monitoring.md
@@ -92,7 +92,7 @@ Examples of use include:
 Full log querying is provided through [Azure Monitor logs](../azure-monitor/log-query/log-query-overview.md). To set up these powerful features:
 
 1. Search for **Log Analytics** in the Azure portal.
-1. You will read your available **Log Analytics workspace** instances. Choose one and select **Logs** to query:
+1. Your available **Log Analytics workspace** instances will be displayed. Choose one and select **Logs** to query:
 
     [![Log analytics](media/how-to-configure-monitoring/log-analytics.png)](media/how-to-configure-monitoring/log-analytics.png#lightbox)
 
diff --git a/articles/digital-twins/how-to-configure-postman.md b/articles/digital-twins/how-to-configure-postman.md
@@ -125,7 +125,7 @@ After completing the previous steps, configure Postman to make an authenticated
    > * You do not need to specify those headers for each part.
    > * You must select `multipart/mixed` or another appropriate  **Content-Type** for the entire request.
 
-1. Lastly, select **Send** to submit your multipart HTTP POST request. A status code of `200` or `201` indicates a successful request. You will also read the appropriate response message.
+1. Lastly, select **Send** to submit your multipart HTTP POST request. A status code of `200` or `201` indicates a successful request. The appropriate response message will appear in the client interface.
 
 ## Next steps
 
diff --git a/articles/digital-twins/how-to-use-swagger.md b/articles/digital-twins/how-to-use-swagger.md
@@ -45,7 +45,7 @@ Management API object models are also listed.
 
 You can select each listed object model for a more detailed summary of key attributes.
 
-[![Swagger models expanded to read contents of models](media/how-to-use-swagger/swagger-management-model-img.png)](media/how-to-use-swagger/swagger-management-model-img.png#lightbox)
+[![Swagger models expanded to read the contents of models](media/how-to-use-swagger/swagger-management-model-img.png)](media/how-to-use-swagger/swagger-management-model-img.png#lightbox)
 
 The generated Swagger object models are convenient to read all available Azure Digital Twins [objects and APIs](./concepts-objectmodel-spatialgraph.md). Developers can use this resource when they build solutions on Azure Digital Twins.
 
@@ -61,13 +61,13 @@ Each listed endpoint also includes the required request information, such as the
 
 [![Swagger endpoints displayed in Swagger UI](media/how-to-use-swagger/swagger-management-endpoints-img.png)](media/how-to-use-swagger/swagger-management-endpoints-img.png#lightbox)
 
-To read a more detailed overview, select each resource.
+Select each resource to display their additional contents to get a more detailed overview.
 
 ## Use Swagger to test endpoints
 
 One of the powerful functionalities Swagger provides is the ability to test an API endpoint directly through the documentation UI.
 
-After you select a specific endpoint, you read **Try it out**.
+After you select a specific endpoint, the **Try it out** button will be displayed.
 
 [![Swagger Try it out button](media/how-to-use-swagger/swagger-management-try-img.png)](media/how-to-use-swagger/swagger-management-try-img.png#lightbox)
 
@@ -79,7 +79,7 @@ After you execute the test, you can validate the response data.
 
 ## Swagger response data
 
-Each listed endpoint also includes response body data to validate your development and tests. These examples include the status codes and JSON you want to read for successful HTTP requests.
+Each listed endpoint also includes response body data to validate your development and tests. These examples include the status codes and JSON for successful HTTP requests.
 
 [![Swagger JSON response example](media/how-to-use-swagger/swagger-management-response-img.png)](media/how-to-use-swagger/swagger-management-response-img.png#lightbox)
 
diff --git a/articles/digital-twins/quickstart-view-occupancy-dotnet.md b/articles/digital-twins/quickstart-view-occupancy-dotnet.md
@@ -99,7 +99,7 @@ Build and run the sensor simulator device application by following these steps.
 1. Run `cd device-connectivity`.
 1. Run `dotnet restore`.
 1. Edit [appsettings.json](https://github.com/Azure-Samples/digital-twins-samples-csharp/blob/master/device-connectivity/appsettings.json) to update **DeviceConnectionString** with the previous `ConnectionString`. Save the updated file.
-1. Run `dotnet run` to start sending sensor data. You read it sent to Digital Twins as shown in the following image.
+1. Run `dotnet run` to start sending sensor data. It will be sent to Azure Digital Twins as shown in the following image.
 
      [![Device Connectivity](media/quickstart-view-occupancy-dotnet/digital-twins-device-connectivity.png)](media/quickstart-view-occupancy-dotnet/digital-twins-device-connectivity.png#lightbox)
 
diff --git a/articles/digital-twins/tutorial-facilities-analyze.md b/articles/digital-twins/tutorial-facilities-analyze.md
@@ -153,7 +153,7 @@ You can use the [Event Hubs](../event-hubs/event-hubs-about.md) service to creat
 
 1. The **Go to Environment** button opens the [Time Series Insights explorer](../time-series-insights/time-series-insights-explorer.md). If it doesn't show any events, simulate device events by browsing to the **device-connectivity** project of your Digital Twins sample, and running `dotnet run`.
 
-1. After a few simulated events are generated, go back to the Time Series Insights explorer, and select the refresh button at the top. You should read analytical charts being created for your simulated sensor data. 
+1. After a few simulated events are generated, go back to the Time Series Insights explorer, and select the refresh button at the top. Your analytical charts that are being created for your simulated sensor data will appear. 
 
     [![Chart in the Time Series Insights explorer](./media/tutorial-facilities-analyze/tsi-explorer.png)](./media/tutorial-facilities-analyze/tsi-explorer.png#lightbox)
 
diff --git a/articles/digital-twins/tutorial-facilities-setup.md b/articles/digital-twins/tutorial-facilities-setup.md
@@ -71,7 +71,7 @@ In the extracted sample folder, open the file **digital-twins-samples-csharp\dig
 
 * You can use the provisioning sample **occupancy-quickstart** to configure and provision a [spatial intelligence graph](concepts-objectmodel-spatialgraph.md#digital-twins-object-models). This graph is the digitized image of your physical spaces and the resources in them. It uses an [object model](concepts-objectmodel-spatialgraph.md#digital-twins-object-models), which defines objects for a smart building. For a complete list of Digital Twins objects and REST APIs, visit [this REST API documentation](https://docs.westcentralus.azuresmartspaces.net/management/swagger) or the Management API URL that was created for [your instance](#deploy-digital-twins).
 
-   To explore the sample to read how it communicates with your Digital Twins instance, you can start with the **src\actions** folder. The files in this folder implement the commands that you'll use in these tutorials:
+   To explore the sample to understand how it communicates with your Digital Twins instance, you can start with the **src\actions** folder. The files in this folder implement the commands that you'll use in these tutorials:
     - The **provisionSample.cs** file shows how to provision your spatial graph.
     - The **getSpaces.cs** file gets information about the provisioned spaces.
     - The **getAvailableAndFreshSpaces.cs** file gets the results of a custom function called a user-defined function.
@@ -98,7 +98,7 @@ In the extracted sample folder, open the file **digital-twins-samples-csharp\dig
    * **Tenant**: Enter the directory ID of your [Azure AD tenant](https://docs.microsoft.com/azure/active-directory/develop/quickstart-create-new-tenant). You also noted this ID in the section where you [set app permissions](#grant-permissions-to-your-app).
    * **BaseUrl**: Enter the URL of your Digital Twins instance. To get this URL, replace the placeholders in this URL with values for your instance: `https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/api/v1.0/`. You can also get this URL by modifying the Management API URL from [the deployment section](#deploy-digital-twins). Replace **swagger/** with **api/v1.0/**.
 
-1. Read a list of Digital Twins features that you can explore by using the sample. Run the following command:
+1. Review a list of Digital Twins features that you can explore by using the sample. Run the following command:
 
     ```cmd/sh
     dotnet run
diff --git a/articles/digital-twins/tutorial-facilities-udf.md b/articles/digital-twins/tutorial-facilities-udf.md
@@ -230,7 +230,7 @@ In this section, you'll use the project named *device-connectivity* in the sampl
 
 ## Get results of the user-defined function
 
-The user-defined function runs every time your instance receives device and sensor data. This section queries your Azure Digital Twins instance to get the results of the user-defined function. You'll read in near real time, when a room is available, that the air is fresh and temperature is right. 
+The user-defined function runs every time your instance receives device and sensor data. This section queries your Azure Digital Twins instance to get the results of the user-defined function. You'll be notified in near real time, when a room is available, that the air is fresh and temperature is right. 
 
 1. Open the command window that you used to provision the sample, or a new command window, and go to the **occupancy-quickstart\src** folder of the sample again.
 
diff --git a/includes/digital-twins-familiarity.md b/includes/digital-twins-familiarity.md
@@ -13,5 +13,5 @@
 
 This article assumes some familiarity with authenticating to your Azure Digital Twins Management APIs.
 
-* To learn more about authenticating with your Management APIs, see [Authenticating with Azure Digital Twins APIs](../articles/digital-twins/security-authenticating-apis.md).
+* To learn more about authenticating with your Management APIs, read [Authenticating with Azure Digital Twins APIs](../articles/digital-twins/security-authenticating-apis.md).
 * To authenticate with your Management APIs using the Postman REST client, read [How to configure Postman](../articles/digital-twins/how-to-configure-postman.md).
