acrolinx fixes

Author: ivorb

learn-pr/wwl-data-ai/secure-ai-services/includes/2-authentication.md

@@ -1,4 +1,4 @@
-In the past, access to Azure AI services resources is restricted by using subscription keys by default. When using keys for authentication, management of access to these keys is a primary consideration for security.
+In the past, access to Azure AI services resources is restricted by using subscription keys by default. When developers use keys for authentication, management of access to these keys is a primary consideration for security.
 
 Some services, most notably when working with Azure AI Foundry, depend on Azure credentials for authentication through Microsoft Entra. This module focuses mostly on keys for security, while other modules focusing on Azure AI Foundry show examples of using Azure credentials for access to you AI services.
 
@@ -21,7 +21,7 @@ For example, to regenerate keys in the Azure portal, you can do the following:
 
 ## Protect keys with Azure Key Vault
 
-Azure Key Vault is an Azure service in which you can securely store secrets (such as passwords and keys). Access to the key vault is granted to *security principals*, which you can think of user identities that are authenticated using Microsoft Entra ID. Administrators can assign a security principal to an application (in which case it is known as a *service principal*) to define a *managed identity* for the application. The application can then use this identity to access the key vault and retrieve a secret to which it has access. Controlling access to the secret in this way minimizes the risk of it being compromised by being hard-coded in an application or saved in a configuration file.
+Azure Key Vault is an Azure service in which you can securely store secrets (such as passwords and keys). Access to the key vault is granted to *security principals*, which you can think of user identities that are authenticated using Microsoft Entra ID. Administrators can assign a security principal to an application (in which case it's known as a *service principal*) to define a *managed identity* for the application. The application can then use this identity to access the key vault and retrieve a secret to which it has access. Controlling access to the secret in this way minimizes the risk of it being compromised by being hard-coded in an application or saved in a configuration file.
 
 You can store the subscription keys for an AI services resource in Azure Key Vault, and assign a managed identity to client applications that need to use the service. The applications can then retrieve the key as needed from the key vault, without risk of exposing it to unauthorized users.
 
@@ -36,7 +36,7 @@ When using the REST interface, some AI services support (or even *require*) toke
 
 ## Microsoft Entra ID authentication
 
-Azure AI services supports Microsoft Entra ID authentication, enabling you to grant access to specific service principals or managed identities for apps and services running in Azure.
+Azure AI services support Microsoft Entra ID authentication, enabling you to grant access to specific service principals or managed identities for apps and services running in Azure.
 
 > [!NOTE]
 > For more information about authentication options for AI services, see the [AI services documentation](/azure/ai-services/authentication).

learn-pr/wwl-data-ai/translate-text-with-translator-service/includes/2-provision-translator-resource.md

@@ -4,13 +4,13 @@
 - One-to-many translation.
 - Script transliteration (converting text from its native script to an alternative script).
 
-:::image type="content" source="../media/translator-resource.png" alt-text="Diagram showing an Azure AI Translator resource performing language detection, one-to-many translation and transliteration.":::
+:::image type="content" source="../media/translator-resource.png" alt-text="Diagram showing an Azure AI Translator resource performing language detection, one-to-many translation, and transliteration.":::
 
 ## Azure resource for Azure AI Translator
 
 To use the Azure AI Translator service, you must provision a resource for it in your Azure subscription. You can provision a single-service Azure AI Translator resource, or you can use the Text Translation API in a multi-service Azure AI Services resource.
 
-After you have provisioned a suitable resource in your Azure subscription, you can use the **location** where you deployed the resource and one of its **subscription keys** to call the Azure AI Translator APIs from your code. You can call the APIs by submitting requests in JSON format to the REST interface, or by using any of the available programming language-specific SDKs.
+After you provision a suitable resource in your Azure subscription, you can use the **location** where you deployed the resource and one of its **subscription keys** to call the Azure AI Translator APIs from your code. You can call the APIs by submitting requests in JSON format to the REST interface, or by using any of the available programming language-specific SDKs.
 
 > [!NOTE]
 > The code examples in the subsequent units in this module show the JSON requests and responses exchanged with the REST interface. When using an SDK, the JSON requests are abstracted by appropriate objects and methods that encapsulate the same data values. You'll get a chance to try the SDK for C# or Python for yourself in the exercise later in the module.