consistency changes to include files

Author: ShawnJackson

articles/app-service/includes/deploy-intelligent-apps/deploy-intelligent-apps-linux-dotnet-pivot.md

@@ -162,7 +162,7 @@ In this step, you add the using statement and create the kernel in a method that
 
 ## 4. Add your AI service
 
-After the kernel is initialized, you can add your chosen AI service to the kernel. You define your model and pass in your key and endpoint information that the chosen model consumes. If you plan to use managed identity with Azure OpenAI, add the service by using the example in the next section.
+After the kernel is initialized, you can add your chosen AI service to the kernel. You define your model and pass in your key and endpoint information that the chosen model consumes. If you plan to use a managed identity with Azure OpenAI, add the service by using the example in the next section.
 
 Use the following code for Azure OpenAI:
 
@@ -189,11 +189,11 @@ builder.Services.AddOpenAIChatCompletion(
 var kernel = builder.Build();
 ```
 
-### Secure your app with managed identity
+### Secure your app with a managed identity
 
-If you're using Azure OpenAI, we highly recommend that you secure your application by using [managed identity](../../overview-managed-identity.md) to authenticate your app to your Azure OpenAI resource. This process enables your application to access the Azure OpenAI resource without managing API keys. If you're not using Azure OpenAI, your secrets can remain secure by using Azure Key Vault as outlined previously.
+If you're using Azure OpenAI, we highly recommend that you secure your application by using a [managed identity](../../overview-managed-identity.md) to authenticate your app to your Azure OpenAI resource. This process enables your application to access the Azure OpenAI resource without managing API keys. If you're not using Azure OpenAI, your secrets can remain secure by using Azure Key Vault as outlined previously.
 
-Complete the following tasks to secure your application with managed identity:
+Complete the following tasks to secure your application with a managed identity.
 
 Add the identity package `Azure.Identity`. By using this package, you can use Azure credentials in your app. Install the package by using NuGet package manager and add the using statement to the top of the `OpenAI.razor` file.
 
@@ -215,13 +215,13 @@ var kernel = Kernel.CreateBuilder()
 
 After the credentials are added to the application, you'll need to enable a managed identity in your application and grant access to the resource.
 
-1. In your web app resource, go to the **Identity** pane and turn on **System assigned** and select **Save**.
+1. In your web app resource, go to the **Identity** pane and turn on **System assigned**, and then select **Save**.
 1. After **System assigned** identity is turned on, it registers the web app with Microsoft Entra ID. The web app can be granted permissions to access protected resources.  
-1. Go to your Azure OpenAI resource and go to the **Access control (IAM)** pane on the left pane.  
+1. Go to your Azure OpenAI resource, and then go to **Access control (IAM)** on the left pane.  
 1. Find the **Grant access to this resource** card and select **Add role assignment**.
 1. Search for the **Cognitive Services OpenAI User** role and select **Next**.
 1. On the **Members** tab, find **Assign access to** and choose the **Managed identity** option.
-1. Next, choose **+Select Members** and find your web app.
+1. Choose **+Select Members** and find your web app.
 1. Select **Review + assign**.
 
 Your web app is now added as a cognitive service OpenAI user and can communicate to your Azure OpenAI resource.

articles/app-service/includes/deploy-intelligent-apps/deploy-intelligent-apps-linux-java-pivot.md

@@ -33,13 +33,13 @@ For this Spring Boot application, you're building off the [quickstart](../../qui
 
 Get the keys and endpoint values from Azure OpenAI or OpenAI and add them as secrets to use in your application. Retrieve and save the values for later use to build the client.
 
-For Azure OpenAI, see [this documentation](/azure/ai-services/openai/quickstart?pivots=programming-language-csharp&tabs=command-line%2Cpython#retrieve-key-and-endpoint) to retrieve the key and endpoint values. If you're planning to use [managed identity](../../overview-managed-identity.md) to secure your app, you need only the `endpoint` value. Otherwise, you need each of the following values:
+For Azure OpenAI, see [this documentation](/azure/ai-services/openai/quickstart?pivots=programming-language-csharp&tabs=command-line%2Cpython#retrieve-key-and-endpoint) to retrieve the key and endpoint values. If you're planning to use a [managed identity](../../overview-managed-identity.md) to secure your app, you need only the `endpoint` value. Otherwise, you need each of the following values:
 
 - `endpoint`
 - `apiKey`
 - `deploymentName`
 
-For OpenAI, see this [documentation](https://platform.openai.com/docs/api-reference) to retrieve the API keys. For this application, you need the following values:
+For OpenAI, see [this documentation](https://platform.openai.com/docs/api-reference) to retrieve the API keys. For this application, you need the following values:
 
 - `apiKey`
 - `modelName`
@@ -48,7 +48,7 @@ Because you're deploying to App Service, you can put these secrets in Azure Key
 
 Next, you can use key vault references as app settings in your App Service resource to reference in the application. Follow the instructions in the [documentation](../../app-service-key-vault-references.md?source=recommendations&tabs=azure-cli) to grant your app access to your key vault and to set up key vault references.
 
-Then, go to the portal **Environment Variables** page in your resource and add the following app settings:
+Then, go to the portal **Environment Variables** page in your resource and add the following app settings.
 
 For Azure OpenAI, use the following settings:
 
@@ -139,9 +139,9 @@ import com.azure.ai.openai.OpenAIClientBuilder;
 import com.azure.core.credential.AzureKeyCredential;
 ```
 
-### Secure your app with managed identity
+### Secure your app with a managed identity
 
-Although optional, we highly recommended that you secure your application using [managed identity](../../overview-managed-identity.md) to authenticate your app to your Azure OpenAI resource. This process enables your application to access the Azure OpenAI resource without managing API keys. Skip this step if you're not using Azure OpenAI.
+Although optional, we highly recommend that you secure your application by using a [managed identity](../../overview-managed-identity.md) to authenticate your app to your Azure OpenAI resource. This process enables your application to access the Azure OpenAI resource without managing API keys. Skip this step if you're not using Azure OpenAI.
 
 To secure your application, complete the following steps:
 
@@ -158,13 +158,13 @@ OpenAIClient client = new OpenAIClientBuilder()
 
 After the credentials are added to the application, enable a managed identity in your application and grant access to the resource:
 
-1. In your web app resource, go to the **Identity** pane and turn on **System assigned** and select **Save**.
+1. In your web app resource, go to the **Identity** pane and turn on **System assigned**, and then select **Save**.
 1. After system-assigned identity is turned on, it will register the web app with Microsoft Entra ID and the web app can be granted permissions to access protected resources.  
-1. Go to your Azure OpenAI resource and go to the **Access control (IAM)** page on the left pane.
+1. Go to your Azure OpenAI resource, and then go to **Access control (IAM)** on the left pane.
 1. Find the **Grant access to this resource** card and select **Add role assignment**.
 1. Search for the **Cognitive Services OpenAI User** role and select **Next**.
 1. On the **Members** tab, find **Assign access to** and choose the **Managed identity** option.
-1. Next, choose **+Select Members**  and find your web app.
+1. Choose **+Select Members**  and find your web app.
 1. Select **Review + assign**.
 
 Your web app is now added as a cognitive service OpenAI user and can communicate to your Azure OpenAI resource.

articles/app-service/includes/deploy-intelligent-apps/deploy-intelligent-apps-linux-node-pivot.md

@@ -42,13 +42,13 @@ First, copy and replace the `index.ejs` file with the following code:
 </html>
 ```
 
-The preceding code adds an input box to our index page to submit requests to OpenAI.
+The preceding code adds an input box to the index page to submit requests to OpenAI.
 
 ### API keys and endpoints
 
 Get the keys and endpoint values from Azure OpenAI or OpenAI and add them as secrets for use in your application. Retrieve and save the values for later use to build the client.
 
-For Azure OpenAI, see [this documentation](/azure/ai-services/openai/quickstart?pivots=programming-language-csharp&tabs=command-line%2Cpython#retrieve-key-and-endpoint) to retrieve the key and endpoint values. If you're planning to use managed identity to secure your app, you need only the `deploymentName` and `apiVersion` values.
+For Azure OpenAI, see [this documentation](/azure/ai-services/openai/quickstart?pivots=programming-language-csharp&tabs=command-line%2Cpython#retrieve-key-and-endpoint) to retrieve the key and endpoint values. If you're planning to use a managed identity to secure your app, you need only the `deploymentName` and `apiVersion` values.
 
 Otherwise, you need each of the following values:
 
@@ -59,15 +59,15 @@ For Azure OpenAI, use the following settings:
 - `deploymentName`
 - `apiVersion`
 
-For OpenAI, see this documentation to retrieve the API keys. For our application, you need the following values:
+For OpenAI, see [this documentation](https://platform.openai.com/docs/api-reference) to retrieve the API keys. For this application, you need the following values:
 
 - `apiKey`
 
-Because you're deploying to App Service, you can put these secrets in Azure Key Vault for protection. Follow the [Quickstart](/azure/key-vault/secrets/quick-create-cli#create-a-key-vault) to set up your key vault and add the secrets that you saved from earlier.
+Because you're deploying to App Service, you can put these secrets in Azure Key Vault for protection. Follow the [quickstart](/azure/key-vault/secrets/quick-create-cli#create-a-key-vault) to set up your key vault and add the secrets that you saved from earlier.
 
-Next, we can use key vault references as app settings in our App Service resource to reference in our application. Follow the instructions in the [documentation](../../app-service-key-vault-references.md?source=recommendations&tabs=azure-cli) to grant your app access to your key vault and to set up key vault references.
+Next, you can use key vault references as app settings in your App Service resource to reference in the application. Follow the instructions in the [documentation](../../app-service-key-vault-references.md?source=recommendations&tabs=azure-cli) to grant your app access to your key vault and to set up key vault references.
 
-Then, go to the portal **Environment Variables** page in your resource and add the following app settings:
+Then, go to the portal **Environment Variables** page in your resource and add the following app settings.
 
 For Azure OpenAI, use the following settings:
 
@@ -104,7 +104,7 @@ const apiKey = process.env.API_KEY;
 
 ### Add the OpenAI package
 
-Before you can create the client, add the Azure OpenAI package. Add the following OpenAI package by using the node package manager.
+Before you can create the client, add the Azure OpenAI package. Add the following OpenAI package by using the Node package manager.
 
 For Azure OpenAI:
 
@@ -120,7 +120,7 @@ npm install openai
 
 ### Create OpenAI client
 
-After the package and environment variables are set up, we can create the client that enables chat completion calls.
+After the package and environment variables are set up, you can create the client that enables chat completion calls.
 
 Add the following code to create the OpenAI client:
 
@@ -147,11 +147,11 @@ import OpenAI from 'openai';
   });
 ```
 
-### Secure your app by using managed identity
+### Secure your app by using a managed identity
 
-Although optional, we highly recommend that you secure your application by using [managed identity](../../overview-managed-identity.md) to authenticate your app to your Azure OpenAI resource. This process enables your application to access the Azure OpenAI resource without needing to manage API keys. Skip this step if you're not using Azure OpenAI.
+Although optional, we highly recommend that you secure your application by using a [managed identity](../../overview-managed-identity.md) to authenticate your app to your Azure OpenAI resource. This process enables your application to access the Azure OpenAI resource without needing to manage API keys. Skip this step if you're not using Azure OpenAI.
 
-To secure your application, complete the following tasks:
+To secure your application, complete the following tasks.
 
 Install the Azure identity package using the Node package manager.
 
@@ -179,18 +179,18 @@ After the credentials are added to the application, enable a managed identity in
 
 1. In your web app resource, go to the **Identity** pane and turn on **System assigned**. Select **Save**.
 1. After system-assigned identity is turned on, it will register the web app with Microsoft Entra ID and the web app can be granted permissions to access protected resources.
-1. Go to your Azure OpenAI resource and go to the **Access control (IAM)** page on the left pane.
+1. Go to your Azure OpenAI resource, and then go to **Access control (IAM)** on the left pane.
 1. Find the **Grant access to this resource** card and select **Add role assignment**.
 1. Search for the **Cognitive Services OpenAI User** role and select **Next**.
 1. On the **Members** tab, find **Assign access to** and choose the **Managed identity** option.
-1. Next, choose **+Select Members** and find your web app.
+1. Choose **+Select Members** and find your web app.
 1. Select **Review + assign**.
 
 Your web app is now added as a cognitive service OpenAI user and can communicate to your Azure OpenAI resource.
 
 ### Set up a prompt and call to OpenAI
 
-We can use chat completions to send our request message to OpenAI and return a response. Add your chat message prompt to the code to be passed to the chat completions method. Use the following code to set up chat completions:
+You can use chat completions to send your request message to OpenAI and return a response. Add your chat message prompt to the code to be passed to the chat completions method. Use the following code to set up chat completions:
 
 ```jsx
 app.post("/api/completions", async (req, res) => {