Merge pull request #100511 from KingdomOfEnds/adt-accessibility

TedA-M · web-flow · commit 0305203e9b56 · 2020-01-09T16:03:12.000-08:00
Accessibility Tweaks
diff --git a/articles/digital-twins/about-digital-twins.md b/articles/digital-twins/about-digital-twins.md
@@ -91,7 +91,7 @@ Azure Digital Twins uses Azure IoT Hub to connect the IoT devices and sensors th
 
 [![Azure Digital Twins is a service built on top of Azure IoT Hub](media/overview/azure-digital-twins-in-iot-ecosystem.png)](media/overview/azure-digital-twins-in-iot-ecosystem.png#lightbox)
 
-For more information about IoT, see [Azure IoT technologies and solutions](../iot-fundamentals/iot-services-and-technologies.md).
+For more information about IoT, read [Azure IoT technologies and solutions](../iot-fundamentals/iot-services-and-technologies.md).
 
 ## Next steps
 
diff --git a/articles/digital-twins/concepts-device-ingress.md b/articles/digital-twins/concepts-device-ingress.md
@@ -16,7 +16,7 @@ The telemetry data sent by devices and sensors form the backbone of any IoT solu
 
 To get started, create an Azure IoT Hub resource at the root of the spatial graph. The IoT Hub resource allows all devices beneath the root space to send messages. After the IoT Hub is created, register devices with sensors within the Digital Twins instance. The devices can send data to a Digital Twins service via the [Azure IoT device SDK](https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-sdks).
 
-For a step-by-step guide on how to bring devices onboard, see the [Tutorial to deploy and configure Digital Twins](tutorial-facilities-setup.md). At a glance, the steps are:
+For a step-by-step guide on how to bring devices onboard, read the [Tutorial to deploy and configure Digital Twins](tutorial-facilities-setup.md). At a glance, the steps are:
 
 - Deploy a Digital Twins instance from the [Azure portal](https://portal.azure.com).
 - Create spaces in your graph.
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**.
-> See 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 |
 | ----------- | -------------- | ----------------- | ----------- | ------------ | --------- |
@@ -57,10 +57,10 @@ Azure Digital Twins currently supports the following **EventTypes** that will be
 | EventGrid|               |         X         |     X       |      X       |   X       |
 
 >[!NOTE]  
->For more information on how to create endpoints and examples of events' schema, see [Egress and endpoints](how-to-egress-endpoints.md).
+>For more information on how to create endpoints and examples of events' schema, read [Egress and endpoints](how-to-egress-endpoints.md).
 
 ## Next steps
 
-- To learn about Azure Digital Twins preview limits, see [Public preview service limits](concepts-service-limits.md).
+- To learn about Azure Digital Twins preview limits, read [Public preview service limits](concepts-service-limits.md).
 
-- To try out an Azure Digital Twins sample, see the [quickstart to find available rooms](quickstart-view-occupancy-dotnet.md).
+- To try out an Azure Digital Twins sample, read the [quickstart to find available rooms](quickstart-view-occupancy-dotnet.md).
diff --git a/articles/digital-twins/concepts-user-defined-functions.md b/articles/digital-twins/concepts-user-defined-functions.md
@@ -99,7 +99,7 @@ User-defined functions can be written in JavaScript. Helper methods interact wit
 - Create a notification when certain conditions are met for an incoming sensor reading.
 - Attach graph metadata to the sensor reading before sending out a notification.
 
-For more information, see [How to use user-defined functions](./how-to-user-defined-functions.md).
+For more information, read [How to use user-defined functions](./how-to-user-defined-functions.md).
 
 #### Examples
 
@@ -109,7 +109,7 @@ The [GitHub repo for the Digital Twins C# sample](https://github.com/Azure-Sampl
 
 ### Role assignment
 
-A user-defined function's actions are subject to Azure Digital Twins [role-based access control](./security-role-based-access-control.md) to secure data within the service. Role assignments define which user-defined functions have the proper permissions to interact with the spatial graph and its entities. For example, a user-defined function might have the ability and permission to *CREATE*, *READ*, *UPDATE*, or *DELETE* graph data under a given space. A user-defined function's level of access is checked when the user-defined function asks the graph for data or attempts an action. For more information, see [Role-based access control](./security-create-manage-role-assignments.md).
+A user-defined function's actions are subject to Azure Digital Twins [role-based access control](./security-role-based-access-control.md) to secure data within the service. Role assignments define which user-defined functions have the proper permissions to interact with the spatial graph and its entities. For example, a user-defined function might have the ability and permission to *CREATE*, *READ*, *UPDATE*, or *DELETE* graph data under a given space. A user-defined function's level of access is checked when the user-defined function asks the graph for data or attempts an action. For more information, read [Role-based access control](./security-create-manage-role-assignments.md).
 
 It's possible for a matcher to trigger a user-defined function that has no role assignments. In this case, the user-defined function fails to read any data from the graph.
 
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 see 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)
 
@@ -104,7 +104,7 @@ Once your **Log Analytics workspace** instance is provisioned, you may use power
 
    [![Log management](media/how-to-configure-monitoring/log-analytics-management.png)](media/how-to-configure-monitoring/log-analytics-management.png#lightbox)
 
-For more information about powerful query operations, see [getting started with queries](../azure-monitor/log-query/get-started-queries.md).
+For more information about powerful query operations, read [getting started with queries](../azure-monitor/log-query/get-started-queries.md).
 
 > [!NOTE]
 > You may experience a 5 minute delay when sending events to **Log Analytics workspace** for the first time.
@@ -118,7 +118,7 @@ Azure Monitor logs also provide powerful error and alert notification services,
 
 ## Other options
 
-Azure Digital Twins also supports application-specific logging and security auditing. For a thorough overview of all Azure logging options available to your Azure Digital Twins instance, see the [Azure log audit](../security/fundamentals/log-audit.md) article.
+Azure Digital Twins also supports application-specific logging and security auditing. For a thorough overview of all Azure logging options available to your Azure Digital Twins instance, read the [Azure log audit](../security/fundamentals/log-audit.md) article.
 
 ## Next steps
 
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 see 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-diagnose-user-defined-functions.md b/articles/digital-twins/how-to-diagnose-user-defined-functions.md
@@ -51,7 +51,7 @@ AzureDiagnostics
 | --- | --- |
 | YOUR_CORRELATION_IDENTIFIER | The Correlation ID that was specified on the event data |
 
-To see all recent telemetry logs query:
+To read all recent telemetry logs query:
 
 ```Kusto
 AzureDiagnostics
diff --git a/articles/digital-twins/how-to-use-swagger.md b/articles/digital-twins/how-to-use-swagger.md
@@ -45,9 +45,9 @@ 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 see 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 see 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.
+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.
 
 ## Endpoint summary
 
@@ -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 see 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 see **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 see 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)
 
@@ -119,7 +119,7 @@ After completing the Azure Active Directory registration:
 
     [![Swagger redirect modal](media/how-to-use-swagger/swagger-auth-redirect-img.png)](media/how-to-use-swagger/swagger-auth-redirect-img.png#lightbox)
 
-To learn more about interactively testing requests protected by OAuth 2.0, see the [official documentation](https://swagger.io/docs/specification/authentication/oauth2/).
+To learn more about interactively testing requests protected by OAuth 2.0, read the [official documentation](https://swagger.io/docs/specification/authentication/oauth2/).
 
 ## Next steps
 
diff --git a/articles/digital-twins/how-to-user-defined-functions.md b/articles/digital-twins/how-to-user-defined-functions.md
@@ -188,11 +188,11 @@ function process(telemetry, executionContext) {
 }
 ```
 
-For a more complex user-defined function code sample, see the [Occupancy quickstart](https://github.com/Azure-Samples/digital-twins-samples-csharp/blob/master/occupancy-quickstart/src/actions/userDefinedFunctions/availability.js).
+For a more complex user-defined function code sample, read the [Occupancy quickstart](https://github.com/Azure-Samples/digital-twins-samples-csharp/blob/master/occupancy-quickstart/src/actions/userDefinedFunctions/availability.js).
 
 ## Create a role assignment
 
-Create a role assignment for the user-defined function to run under. If no role assignment exists for the user-defined function, it won't have the proper permissions to interact with the Management API or have access to perform actions on graph objects. Actions that a user-defined function may perform are specified and defined via role-based access control within the Azure Digital Twins Management APIs. For example, user-defined functions can be limited in scope by specifying certain roles or certain access control paths. For more information, see the [Role-based access control](./security-role-based-access-control.md) documentation.
+Create a role assignment for the user-defined function to run under. If no role assignment exists for the user-defined function, it won't have the proper permissions to interact with the Management API or have access to perform actions on graph objects. Actions that a user-defined function may perform are specified and defined via role-based access control within the Azure Digital Twins Management APIs. For example, user-defined functions can be limited in scope by specifying certain roles or certain access control paths. For more information, read the [Role-based access control](./security-role-based-access-control.md) documentation.
 
 1. [Query the System API](./security-create-manage-role-assignments.md#retrieve-all-roles) for all roles to get the role ID you want to assign to your user-defined function. Do so by making an authenticated HTTP GET request to:
 
diff --git a/articles/digital-twins/quickstart-view-occupancy-dotnet.md b/articles/digital-twins/quickstart-view-occupancy-dotnet.md
@@ -10,7 +10,7 @@ ms.devlang: csharp
 ms.topic: quickstart
 ms.custom: mvc seodec18
 ms.date: 11/12/2019
-# As a developer new to Azure Digital Twins, I need to see how to send motion and carbon dioxide telemetry to a space in Azure Digital Twins and how to find available rooms with fresh air by using a back-end application. 
+# As a developer new to Azure Digital Twins, I need to understand how to send motion and carbon dioxide telemetry to a space in Azure Digital Twins and how to find available rooms with fresh air by using a back-end application. 
 ---
 
 # Quickstart: Find available rooms by using Azure Digital Twins
@@ -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 see 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)
 
@@ -159,7 +159,7 @@ To continue to the tutorials, don't clean up the resources created in this quick
 
 ## Next steps
 
-This quickstart used a simple scenario and sample applications to show how Digital Twins can be used to find rooms with good working conditions. For in-depth analysis of this scenario, see this tutorial:
+This quickstart used a simple scenario and sample applications to show how Digital Twins can be used to find rooms with good working conditions. For in-depth analysis of this scenario, read this tutorial:
 
 >[!div class="nextstepaction"]
 >[Tutorial: Deploy Azure Digital Twins and configure a spatial graph](tutorial-facilities-setup.md)
diff --git a/articles/digital-twins/security-authenticating-apis.md b/articles/digital-twins/security-authenticating-apis.md
@@ -19,7 +19,7 @@ For an overview of Azure AD, visit the [fundamentals page](https://docs.microsof
 > [!TIP]
 > Follow the [Tutorial](tutorial-facilities-setup.md) to set up and run an Azure Digital Twins sample app.
 
-To integrate an application or service with Azure AD, a developer must first register the application with Azure AD. For detailed instructions and screenshots, see [this quickstart](../active-directory/develop/quickstart-register-app.md).
+To integrate an application or service with Azure AD, a developer must first register the application with Azure AD. For detailed instructions and screenshots, read [this quickstart](../active-directory/develop/quickstart-register-app.md).
 
 [Five primary application scenarios](../active-directory/develop/v2-app-types.md) are supported by Azure AD:
 
@@ -44,7 +44,7 @@ When developers architect Digital Twins solutions, they typically create a middl
 
 1. The acquired token is then used to authenticate with or call APIs that are further downstream using the On-Behalf-Of flow
 
-For instructions about how to orchestrate the on-behalf-of flow, see [OAuth 2.0 On-Behalf-Of flow](https://docs.microsoft.com/azure/active-directory/develop/v2-oauth2-on-behalf-of-flow). You also can view code samples in [Calling a downstream web API](https://github.com/Azure-Samples/active-directory-dotnet-webapi-onbehalfof).
+For instructions about how to orchestrate the on-behalf-of flow, read [OAuth 2.0 On-Behalf-Of flow](https://docs.microsoft.com/azure/active-directory/develop/v2-oauth2-on-behalf-of-flow). You also can view code samples in [Calling a downstream web API](https://github.com/Azure-Samples/active-directory-dotnet-webapi-onbehalfof).
 
 ## Next steps
 
diff --git a/articles/digital-twins/security-best-practices.md b/articles/digital-twins/security-best-practices.md
@@ -41,7 +41,7 @@ Some key practices to safely secure an IoT space include:
 > [!div class="checklist"]
 > * Encrypt saved, stored, or persistent data.
 > * Require passwords or keys to be periodically changed or refreshed.
-> * Carefully restrict access and permissions by role. See the section [Role-based access control best practices](#role-based-access-control-best-practices) below.
+> * Carefully restrict access and permissions by role. Read the section [Role-based access control best practices](#role-based-access-control-best-practices) below.
 > * Consider a divided network topology so that devices on each network are isolated from the others.
 > * Use powerful encryption. Require long passwords, use secure protocols, and [multi-factor authentication](https://docs.microsoft.com/azure/active-directory/authentication/concept-mfa-howitworks).
 
@@ -51,7 +51,7 @@ Some key practices to safely secure an IoT space include:
 > Read Azure [IoT security best practices](../iot-fundamentals/iot-security-best-practices.md) to begin a comprehensive IoT security strategy.
 
 > [!NOTE]
-> For more information on event processing and monitoring, see [Route events and messages with Azure Digital Twins](./concepts-events-routing.md).
+> For more information on event processing and monitoring, read [Route events and messages with Azure Digital Twins](./concepts-events-routing.md).
 
 ## Azure Active Directory best practices
 
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 see 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
diff --git a/articles/digital-twins/tutorial-facilities-udf.md b/articles/digital-twins/tutorial-facilities-udf.md
diff --git a/includes/digital-twins-familiarity.md b/includes/digital-twins-familiarity.md

Original file line number	Diff line number	Diff line change
`@@ -188,11 +188,11 @@ function process(telemetry, executionContext) {`
`188`	`188`	`}`
`189`	`189`	```
`190`	`190`
`191`		`-For a more complex user-defined function code sample, see the [Occupancy quickstart](https://github.com/Azure-Samples/digital-twins-samples-csharp/blob/master/occupancy-quickstart/src/actions/userDefinedFunctions/availability.js).`
	`191`	`+For a more complex user-defined function code sample, read the [Occupancy quickstart](https://github.com/Azure-Samples/digital-twins-samples-csharp/blob/master/occupancy-quickstart/src/actions/userDefinedFunctions/availability.js).`
`192`	`192`
`193`	`193`	`## Create a role assignment`
`194`	`194`
`195`		-Create a role assignment for the user-defined function to run under. If no role assignment exists for the user-defined function, it won't have the proper permissions to interact with the Management API or have access to perform actions on graph objects. Actions that a user-defined function may perform are specified and defined via role-based access control within the Azure Digital Twins Management APIs. For example, user-defined functions can be limited in scope by specifying certain roles or certain access control paths. For more information, see the [Role-based access control](./security-role-based-access-control.md) documentation.
	`195`	+Create a role assignment for the user-defined function to run under. If no role assignment exists for the user-defined function, it won't have the proper permissions to interact with the Management API or have access to perform actions on graph objects. Actions that a user-defined function may perform are specified and defined via role-based access control within the Azure Digital Twins Management APIs. For example, user-defined functions can be limited in scope by specifying certain roles or certain access control paths. For more information, read the [Role-based access control](./security-role-based-access-control.md) documentation.
`196`	`196`
`197`	`197`	`1. [Query the System API](./security-create-manage-role-assignments.md#retrieve-all-roles) for all roles to get the role ID you want to assign to your user-defined function. Do so by making an authenticated HTTP GET request to:`
`198`	`198`