Updated all include files

Edited all include files and ran Acrolinx to align with current standards

Author: vac0224

articles/communication-services/quickstarts/identity/includes/access-tokens/access-token-az-cli.md

@@ -18,22 +18,24 @@ ms.author: dademath
 - An active Communication Services resource and connection string. [Create a Communication Services resource](../../../create-communication-resource.md?#access-your-connection-strings-and-service-endpoints-using-azure-cli).
 - Install [Azure CLI](/cli/azure/install-azure-cli-windows?tabs=azure-cli).
 
-## Setting up
+## Set up your environment
 
 ### Add the extension
-Add the Azure Communication Services extension for Azure CLI by using the `az extension` command.
+
+Add the Azure Communication Services extension for Azure CLI using the `az extension` command.
 
 ```azurecli-interactive
 az extension add --name communication
 ```
 
 ### Sign in to Azure CLI
-You'll need to [sign in to Azure CLI](/cli/azure/authenticate-azure-cli). You can sign in running the ```az login``` command from the terminal and providing your credentials.
+
+You need to [sign in to Azure CLI](/cli/azure/authenticate-azure-cli). You can sign in running the ```az login``` command from the terminal, then provide your credentials.
 
 
 ### (Optional) Use Azure CLI identity operations without passing in a connection string
 
-You can configure the `AZURE_COMMUNICATION_CONNECTION_STRING` environment variable to use Azure CLI identity operations without having to use `--connection_string` to pass in the connection string. To configure an environment variable, open a console window and select your operating system from the below tabs. Replace `<yourConnectionString>` with your actual connection string.
+You can configure the `AZURE_COMMUNICATION_CONNECTION_STRING` environment variable to use Azure CLI identity operations without having to use `--connection_string` to pass in the connection string. To configure an environment variable, open a console window and select your operating system from the following tabs. Replace `<yourConnectionString>` with your actual connection string.
 
 #### [Windows](#tab/windows)
 
@@ -43,7 +45,7 @@ Open a console window and enter the following command:
 setx AZURE_COMMUNICATION_CONNECTION_STRING "<yourConnectionString>"
 ```
 
-After you add the environment variable, you may need to restart any running programs that will need to read the environment variable, including the console window. For example, if you're using Visual Studio as your editor, restart Visual Studio before running the example.
+After you add the environment variable, you might need to restart any running programs that need to read the environment variable, including the console window. For example, if you're using Visual Studio as your editor, restart Visual Studio before running the example.
 
 #### [macOS](#tab/unix)
 
@@ -53,7 +55,7 @@ Edit your **`.zshrc`**, and add the environment variable:
 export AZURE_COMMUNICATION_CONNECTION_STRING="<yourConnectionString>"
 ```
 
-After you add the environment variable, run `source ~/.zshrc` from your console window to make the changes effective. If you created the environment variable with your IDE open, you may need to close and reopen the editor, IDE, or shell in order to access the variable.
+After you add the environment variable, run `source ~/.zshrc` from your console window to make the changes effective. If you created the environment variable with your IDE open, you might need to close and reopen the editor, IDE, or shell in order to access the variable.
 
 #### [Linux](#tab/linux)
 
@@ -63,7 +65,7 @@ Edit your **`.bash_profile`**, and add the environment variable:
 export AZURE_COMMUNICATION_CONNECTION_STRING="<yourConnectionString>"
 ```
 
-After you add the environment variable, run `source ~/.bash_profile` from your console window to make the changes effective. If you created the environment variable with your IDE open, you may need to close and reopen the editor, IDE, or shell in order to access the variable.
+After you add the environment variable, run `source ~/.bash_profile` from your console window to make the changes effective. If you created the environment variable with your IDE open, you might need to close and reopen the editor, IDE, or shell in order to access the variable.
 
 ---
 
@@ -79,7 +81,7 @@ Open a console window and enter the following command:
 setx AZURE_COMMUNICATION_ACCESS_TOKEN "<yourAccessToken>"
 ```
 
-After you add the environment variable, you may need to restart any running programs that will need to read the environment variable, including the console window. For example, if you're using Visual Studio as your editor, restart Visual Studio before running the example.
+After you add the environment variable, you might need to restart any running programs that need to read the environment variable, including the console window. For example, if you're using Visual Studio as your editor, restart Visual Studio before running the example.
 
 #### [macOS](#tab/unix)
 
@@ -89,7 +91,7 @@ Edit your **`.zshrc`**, and add the environment variable:
 export AZURE_COMMUNICATION_ACCESS_TOKEN="<yourAccessToken>"
 ```
 
-After you add the environment variable, run `source ~/.zshrc` from your console window to make the changes effective. If you created the environment variable with your IDE open, you may need to close and reopen the editor, IDE, or shell in order to access the variable.
+After you add the environment variable, run `source ~/.zshrc` from your console window to make the changes effective. If you created the environment variable with your IDE open, you might need to close and reopen the editor, IDE, or shell in order to access the variable.
 
 #### [Linux](#tab/linux)
 
@@ -99,7 +101,7 @@ Edit your **`.bash_profile`**, and add the environment variable:
 export AZURE_COMMUNICATION_ACCESS_TOKEN="<yourAccessToken>"
 ```
 
-After you add the environment variable, run `source ~/.bash_profile` from your console window to make the changes effective. If you created the environment variable with your IDE open, you may need to close and reopen the editor, IDE, or shell in order to access the variable.
+After you add the environment variable, run `source ~/.bash_profile` from your console window to make the changes effective. If you created the environment variable with your IDE open, you might need to close and reopen the editor, IDE, or shell in order to access the variable.
 
 ---
 
@@ -159,7 +161,7 @@ Access tokens are short-lived credentials that need to be reissued. Not doing so
 
 <a name='exchange-an-azure-ad-access-token-of-the-teams-user-for-a-communication-identity-access-token'></a>
 
-### Exchange a Microsoft Entra access token of the Teams User for a Communication Identity access token
+### Exchange a Microsoft Entra access token of the Teams user for a Communication Identity access token
 
 Use the `token get-for-teams-user` command to issue an access token for the Teams user that can be used with the Azure Communication Services SDKs.
 
@@ -171,12 +173,12 @@ Make this replacement in the code:
 
 - Replace `<yourConnectionString>` with your connection string.
 - Replace `<yourAadUser>` with your Microsoft Entra userId.
-- Replace `<yourAadApplication>` with your Microsoft Entra application Id.
+- Replace `<yourAadApplication>` with your Microsoft Entra application ID.
 - Replace `<yourAadToken>` with your Microsoft Entra access token.
 
 ### Revoke access tokens
 
-You might occasionally need to explicitly revoke an access token. For example, you would do so when application users change the password they use to authenticate to your service. The `token revoke` command invalidates all active access tokens that were issued to the identity.
+You might need to explicitly revoke an access token. For example, you would do so when application users change the password they use to authenticate to your service. The `token revoke` command invalidates all active access tokens that were issued to the identity.
 
 ```azurecli-interactive
 az communication identity token revoke --user "<userId>" --connection-string "<yourConnectionString>"
@@ -189,7 +191,7 @@ Make this replacement in the code:
 
 ### Delete an identity
 
-When you delete an identity, you revoke all active access tokens and prevent the further issuance of access tokens for the identity. Doing so also removes all persisted content that's associated with the identity.
+When you delete an identity, you revoke all active access tokens and prevent the further issuance of access tokens for the identity. Doing so also removes all persisted content associated with the identity.
 
 ```azurecli-interactive
 az communication identity user delete --user "<userId>" --connection-string "<yourConnectionString>"

articles/communication-services/quickstarts/identity/includes/access-tokens/access-token-az-portal.md

@@ -15,16 +15,20 @@ ms.custom: mode-other
 
 ## Prerequisites
 
-- An [Azure Communication Services resource](../../../create-communication-resource.md)
+- An [Azure Communication Services resource](../../../create-communication-resource.md).
 
 ## Create the access tokens
 
-In the [Azure portal](https://portal.azure.com), navigate to the **Identities & User Access Tokens** blade within your Communication Services resource. 
+1. In the [Azure portal](https://portal.azure.com), navigate to the **Identities & User Access Tokens** blade in your Communication Services resource. 
 
-Choose the scope of the access tokens. You can select none, one, or multiple. Click **Generate**.
+2. Choose the scope of the access tokens. You can choose none, one, or multiple services. 
 
-![Select the scopes of the identity and access tokens.](../../media/quick-create-identity-choose-scopes.png)
+3. Select **Generate**.
 
-You'll see an identity and corresponding user access token generated. You can copy these strings and use them in the [sample apps](../../../../samples/overview.md) and other testing scenarios.
+   :::image type="content" source="../../media/quick-create-identity-choose-scopes.png" alt-text="Screenshot that shows the scopes of the identity and access tokens where you select Generate." lightbox="../../media/quick-create-identity-choose-scopes.png":::
 
-![The identity and access tokens are generated and show the expiration date.](../../media/quick-create-identity-generated.png) 
+   The system generates an identity and corresponding user access token.
+
+4. Copy these strings and use them in the [sample apps](../../../../samples/overview.md) and other testing scenarios.
+
+   :::image type="content" source="../../media/quick-create-identity-generated.png" alt-text="Screenshot that shows the identity and access tokens with expiration date" lightbox="../../media/quick-create-identity-generated.png":::

articles/communication-services/quickstarts/identity/includes/access-tokens/access-token-java.md

@@ -20,23 +20,24 @@ ms.author: tchladek
 - An active Communication Services resource and connection string. [Create a Communication Services resource](../../../create-communication-resource.md).
 
 ## Final code
-Find the finalized code for this quickstart on [GitHub](https://github.com/Azure-Samples/communication-services-java-quickstarts/tree/main/access-token-quickstart).
+
+Find the finalized code at [GitHub](https://github.com/Azure-Samples/communication-services-java-quickstarts/tree/main/access-token-quickstart).
 
 ## Set up your environment
 
 ### Create a new Java application
 
-In a terminal or Command Prompt window, go to the directory where you want to create your Java application. To generate a Java project from the maven-archetype-quickstart template, run the following code:
+In a terminal or command prompt window, go to the directory where you want to create your Java application. To generate a Java project from the maven-archetype-quickstart template, run the following code:
 
 ```console
 mvn archetype:generate -DgroupId=com.communication.quickstart -DartifactId=communication-quickstart -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false
 ```
 
-You'll notice that the `generate` task creates a directory with the same name as `artifactId`. Under this directory, the *src/main/java* directory contains the project source code, the *src/test/java* directory contains the test source, and the *pom.xml* file is the project's Project Object Model, or POM. This file is used for project configuration parameters.
+Notice that the `generate` task creates a directory with the same name as `artifactId`. Under this directory, the `src/main/java` directory contains the project source code, the `src/test/java` directory contains the test source, and the `pom.xml` file is the project's Project Object Model, or POM. This file is used for project configuration parameters.
 
 ### Install the Communication Services packages
 
-Open the *pom.xml* file in your text editor. Add the following dependency element to the group of dependencies:
+Open the `pom.xml` file in your text editor. Add the following dependency element to the group of dependencies:
 
 ```xml
 <dependency>
@@ -46,14 +47,14 @@ Open the *pom.xml* file in your text editor. Add the following dependency elemen
 </dependency>
 ```
 
-This code instructs Maven to install the Communication Services Identity SDK, which you'll use later.
+This code instructs Maven to install the Communication Services Identity SDK, which you need to use later.
 
 ### Set up the app framework
 
-In the project directory, do the following:
+In the project directory, complete the following steps:
 
-1. Go to the */src/main/java/com/communication/quickstart* directory.
-1. Open the *App.java* file in your editor.
+1. Go to the `/src/main/java/com/communication/quickstart` directory.
+1. Open the `App.java` file in your editor.
 1. Replace the `System.out.println("Hello world!");` statement.
 1. Add `import` directives.
 
@@ -83,11 +84,11 @@ public class App
 
 ## Authenticate the client
 
-Instantiate a `CommunicationIdentityClient` with your resource's access key and endpoint. For more information, see the "Store your connection string" section of [Create and manage Communication Services resources](../../../create-communication-resource.md#store-your-connection-string). 
+Instantiate a `CommunicationIdentityClient` with your resource's access key and endpoint. For more information, see [Create and manage Communication Services resources > Store your connection string](../../../create-communication-resource.md#store-your-connection-string). 
 
-In addition, you can initialize the client with any custom HTTP client that implements the `com.azure.core.http.HttpClient` interface.
+You can also initialize the client with any custom HTTP client that implements the `com.azure.core.http.HttpClient` interface.
 
-In the *App.java* file, add the following code to the `main` method:
+In the `App.java` file, add the following code to the `main` method:
 
 ```java
 // You can find your endpoint and access key from your resource in the Azure portal
@@ -111,7 +112,7 @@ CommunicationIdentityClient communicationIdentityClient = new CommunicationIdent
     .buildClient();
 ```
 
-If you've already set up a Microsoft Entra application, you can [authenticate by using Microsoft Entra ID](../../../identity/service-principal.md).
+If you already set up a Microsoft Entra application, you can [authenticate by using Microsoft Entra ID](../../../identity/service-principal.md).
 
 ```java
 String endpoint = "https://<RESOURCE_NAME>.communication.azure.com";
@@ -132,7 +133,7 @@ CommunicationUserIdentifier user = communicationIdentityClient.createUser();
 System.out.println("\nCreated an identity with ID: " + user.getId());
 ```
 
-The created identity is required later for issuing access tokens. Store the received identity with mapping to your application's users (for example, by storing it in your application server database). 
+The created identity is required later to issue access tokens. Store the received identity with mapping to your application's users (for example, by storing it in your application server database). 
 
 ## Issue an access token
 
@@ -149,11 +150,11 @@ String token = accessToken.getToken();
 System.out.println("\nIssued an access token with 'voip' scope that expires at: " + expiresAt + ": " + token);
 ```
 
-Access tokens are short-lived credentials that need to be reissued. Not doing so might cause a disruption of your application users' experience. The `expiresAt` property indicates the lifetime of the access token.
+Access tokens are short-lived credentials that need to be reissued. Not doing so might cause a disruption of your application user experience. The `expiresAt` property indicates the lifetime of the access token.
 
 ## Set a custom token expiration time
 
-The default token expiration time is 24 hours, but you can configure it by providing a value between an hour and 24 hours to the optional parameter `tokenExpiresIn`. When requesting a new token, it's recommended that you specify the expected typical length of a communication session for the token expiration time.
+The default token expiration time is 24 hours, but you can configure it by providing a value between an hour and 24 hours to the optional parameter `tokenExpiresIn`. When requesting a new token, specify the expected typical length of a communication session for the token expiration time.
 
 ```java
 // Issue an access token with a validity of an hour and the "voip" scope for a user identity
@@ -164,8 +165,7 @@ AccessToken accessToken = communicationIdentityClient.getToken(user, scopes, tok
 
 ## Create an identity and issue a token in one request
 
-Alternatively, you can use the 'createUserAndToken' method to create a new entry in the directory with a unique `Id` and
-issue an access token at the same time.
+Alternatively, you can use the 'createUserAndToken' method to create a new entry in the directory with a unique `Id` and issue an access token at the same time.
 
 ```java
 //Create an identity and issue token with a validity of 24 hours in one call
@@ -191,7 +191,7 @@ AccessToken response = communicationIdentityClient.getToken(identity, scopes);
 
 ## Revoke an access token
 
-You might occasionally need to explicitly revoke an access token. For example, you would do so when application users change the password they use to authenticate to your service. The `revokeTokens` method invalidates all active access tokens for a particular user. In the following code, you can use the previously created user.
+You might need to explicitly revoke an access token. For example, you would do so when application users change the password they use to authenticate to your service. The `revokeTokens` method invalidates all active access tokens for a particular user. In the following code, you can use the previously created user.
 
 ```java
 communicationIdentityClient.revokeTokens(user);
@@ -200,7 +200,7 @@ System.out.println("\nSuccessfully revoked all access tokens for user identity w
 
 ## Delete an identity
 
-When you delete an identity, you revoke all active access tokens and prevent the further issuance of access tokens for the identity. Doing so also removes all persisted content that's associated with the identity.
+When you delete an identity, you revoke all active access tokens and prevent the further issuance of access tokens for the identity. Doing so also removes all persisted content associated with the identity.
 
 ```java
 communicationIdentityClient.deleteUser(user);
@@ -209,25 +209,27 @@ System.out.println("\nDeleted the user identity with ID: " + user.getId());
 
 ## Run the code
 
-Go to the directory that contains the *pom.xml* file, and then compile the project by using the following `mvn` command:
+1. Go to the directory that contains the `pom.xml` file.
 
-```console
-mvn compile
-```
+2. Compile the project using the following `mvn` command:
 
-Then, build the package:
+   ```console
+   mvn compile
+   ```
 
-```console
-mvn package
-```
+3. build the package:
 
-Run the following `mvn` command to execute the app:
+   ```console
+   mvn package
+   ```
 
-```console
-mvn exec:java -Dexec.mainClass="com.communication.quickstart.App" -Dexec.cleanupDaemonThreads=false
-```
+4. Run the following `mvn` command to execute the app:
+
+   ```console
+   mvn exec:java -Dexec.mainClass="com.communication.quickstart.App" -Dexec.cleanupDaemonThreads=false
+   ```
 
-The app's output describes each completed action:
+The output describes each completed action:
 
 <!---cSpell:disable --->
 ```console