Merge pull request #267649 from MicrosoftDocs/main

2/29 11:00 AM IST Publish

Author: Saisang

articles/ai-services/immersive-reader/how-to-cache-token.md

@@ -1,24 +1,24 @@
 ---
 title: "Cache the authentication token"
 titleSuffix: Azure AI services
-description: This article will show you how to cache the authentication token.
-author: rwallerms
+description: Learn how to cache the authentication token in the Immersive Reader app.
+author: sharmas
 manager: nitinme
 
 ms.service: azure-ai-immersive-reader
 ms.topic: how-to
-ms.date: 01/14/2020
-ms.author: rwaller
+ms.date: 02/26/2024
+ms.author: sharmas
 ms.custom: "devx-track-js, devx-track-csharp"
 ---
 
 # How to cache the authentication token
 
-This article demonstrates how to cache the authentication token in order to improve performance of your application.
+This article demonstrates how to cache the authentication token in order to improve the performance of your application.
 
 ## Using ASP.NET
 
-Import the **Microsoft.Identity.Client** NuGet package, which is used to acquire a token.
+Import the `Microsoft.Identity.Client` NuGet package, which is used to acquire a token. For details, see [Install Identity Client NuGet package](quickstarts/client-libraries.md?pivots=programming-language-csharp#install-identity-client-nuget-package).
 
 Create a confidential client application property.
 
@@ -42,7 +42,7 @@ private IConfidentialClientApplication ConfidentialClientApplication
 Next, use the following code to acquire an `AuthenticationResult`, using the authentication values you got when you [created the Immersive Reader resource](./how-to-create-immersive-reader.md).
 
 > [!IMPORTANT]
-> The [Microsoft.IdentityModel.Clients.ActiveDirectory](https://www.nuget.org/packages/Microsoft.IdentityModel.Clients.ActiveDirectory) NuGet package and Azure AD Authentication Library (ADAL) have been deprecated. No new features have been added since June 30, 2020.   We strongly encourage you to upgrade, see the [migration guide](../../active-directory/develop/msal-migration.md) for more details.
+> The [Microsoft.IdentityModel.Clients.ActiveDirectory](https://www.nuget.org/packages/Microsoft.IdentityModel.Clients.ActiveDirectory) NuGet package and Azure AD Authentication Library (ADAL) have been deprecated. No new features have been added since June 30, 2020. We strongly encourage you to upgrade. To learn more, see the [migration guide](../../active-directory/develop/msal-migration.md).
 
 
 ```csharp
@@ -59,11 +59,11 @@ public async Task<string> GetTokenAsync()
 }
 ```
 
-The `AuthenticationResult` object has an `AccessToken` property which is the actual token you will use when launching the Immersive Reader using the SDK. It also has an `ExpiresOn` property which denotes when the token will expire. Before launching the Immersive Reader, you can check whether the token has expired, and acquire a new token only if it has expired.
+The `AuthenticationResult` object has an `AccessToken` property, which is the actual token you use when launching the Immersive Reader using the SDK. It also has an `ExpiresOn` property that denotes when the token expires. Before launching the Immersive Reader, you can check whether the token is expired, and acquire a new token only if it expired.
 
 ## Using Node.JS
 
-Add the [**request**](https://www.npmjs.com/package/request) npm package to your project. Use the following code to acquire a token, using the authentication values you got when you [created the Immersive Reader resource](./how-to-create-immersive-reader.md).
+Add the [request](https://www.npmjs.com/package/request) npm package to your project. Use the following code to acquire a token, using the authentication values you got when you [created the Immersive Reader resource](./how-to-create-immersive-reader.md).
 
 ```javascript
 router.get('/token', function(req, res) {
@@ -89,7 +89,7 @@ router.get('/token', function(req, res) {
 });
 ```
 
-The `expires_on` property is the date and time at which the token expires, expressed as the number of seconds since January 1, 1970 UTC. Use this value to determine whether your token has expired before attempting to acquire a new one.
+The `expires_on` property is the date and time at which the token expires, expressed as the number of seconds since January 1, 1970 UTC. Use this value to determine whether your token is expired before attempting to acquire a new one.
 
 ```javascript
 async function getToken() {
@@ -100,6 +100,7 @@ async function getToken() {
 }
 ```
 
-## Next steps
+## Next step
 
-* Explore the [Immersive Reader SDK Reference](./reference.md)
+> [!div class="nextstepaction"]
+> [Explore the Immersive Reader SDK reference](reference.md)

articles/ai-services/immersive-reader/how-to-configure-read-aloud.md

@@ -1,19 +1,19 @@
 ---
 title: "Configure Read Aloud"
 titleSuffix: Azure AI services
-description: This article will show you how to configure the various options for Read Aloud.
-author: rwallerms
+description: Learn how to configure the various options for Read Aloud in Immersive Reader.
+author: sharmas
 manager: nitinme
 
 ms.service: azure-ai-immersive-reader
 ms.topic: how-to
-ms.date: 06/29/2020
-ms.author: rwaller
+ms.date: 02/26/2024
+ms.author: sharmas
 ---
 
 # How to configure Read Aloud
 
-This article demonstrates how to configure the various options for Read Aloud in the Immersive Reader.
+This article demonstrates how to configure the various options for Read Aloud in your Immersive Reader application.
 
 ## Automatically start Read Aloud
 
@@ -34,7 +34,7 @@ ImmersiveReader.launchAsync(YOUR_TOKEN, YOUR_SUBDOMAIN, YOUR_DATA, options);
 
 ## Configure the voice
 
-Set `voice` to either `male` or `female`. Not all languages support both voices. For more information, see the [Language Support](./language-support.md) page.
+Set `voice` to either `male` or `female`. Not all languages support both voices. For more information, see [Language support](./language-support.md).
 
 ```typescript
 const options = {
@@ -46,7 +46,7 @@ const options = {
 
 ## Configure playback speed
 
-Set `speed` to a number between `0.5` (50%) and `2.5` (250%) inclusive. Values outside this range will get clamped to either 0.5 or 2.5.
+Set `speed` to a number between `0.5` (50%) and `2.5` (250%) inclusive. Values outside this range get clamped to either 0.5 or 2.5.
 
 ```typescript
 const options = {
@@ -56,6 +56,7 @@ const options = {
 };
 ```
 
-## Next steps
+## Next step
 
-* Explore the [Immersive Reader SDK Reference](./reference.md)
+> [!div class="nextstepaction"]
+> [Explore the Immersive Reader SDK reference](reference.md)

articles/ai-services/immersive-reader/how-to-configure-translation.md

@@ -1,14 +1,14 @@
 ---
-title: "Configure translation"
+title: Configure translation in Immersive Reader
 titleSuffix: Azure AI services
-description: This article will show you how to configure the various options for translation.
-author: rwallerms
+description: Learn how to configure the various Immersive Reader options for translation.
+author: sharmas
 manager: nitinme
 
 ms.service: azure-ai-immersive-reader
 ms.topic: how-to
-ms.date: 01/06/2022
-ms.author: rwaller
+ms.date: 02/27/2024
+ms.author: sharmas
 ---
 
 # How to configure Translation
@@ -17,7 +17,7 @@ This article demonstrates how to configure the various options for Translation i
 
 ## Configure Translation language
 
-The `options` parameter contains all of the flags that can be used to configure Translation. Set the `language` parameter to the language you wish to translate to. See the [Language Support](./language-support.md) for the full list of supported languages.
+The `options` parameter contains all of the flags that can be used to configure Translation. Set the `language` parameter to the language you wish to translate to. For the full list of supported languages, see [Language support](language-support.md).
 
 ```typescript
 const options = {
@@ -31,7 +31,7 @@ ImmersiveReader.launchAsync(YOUR_TOKEN, YOUR_SUBDOMAIN, YOUR_DATA, options);
 
 ## Automatically translate the document on load
 
-Set `autoEnableDocumentTranslation` to `true` to enable automatically translating the entire document when the Immersive Reader loads.
+Set `autoEnableDocumentTranslation` to `true` to enable automatic translation of the entire document when the Immersive Reader loads.
 
 ```typescript
 const options = {
@@ -41,7 +41,7 @@ const options = {
 };
 ```
 
-## Automatically enable word translation
+## Enable automatic word translation
 
 Set `autoEnableWordTranslation` to `true` to enable single word translation.
 
@@ -53,6 +53,7 @@ const options = {
 };
 ```
 
-## Next steps
+## Next step
 
-* Explore the [Immersive Reader SDK Reference](./reference.md)
+> [!div class="nextstepaction"]
+> [Explore the Immersive Reader SDK reference](reference.md)

articles/ai-services/immersive-reader/how-to-customize-launch-button.md

@@ -1,79 +1,80 @@
 ---
 title: "Edit the Immersive Reader launch button"
 titleSuffix: Azure AI services
-description: This article will show you how to customize the button that launches the Immersive Reader.
+description: Learn how to customize the button that launches the Immersive Reader app.
 #services: cognitive-services
-author: rwallerms
+author: sharmas
 manager: nitinme
 
 ms.service: azure-ai-immersive-reader
 ms.topic: how-to
-ms.date: 03/08/2021
-ms.author: rwaller
+ms.date: 02/23/2024
+ms.author: sharmas
 ---
 
 # How to customize the Immersive Reader button
 
-This article demonstrates how to customize the button that launches the Immersive Reader to fit the needs of your application.
+This article demonstrates how to customize the button that launches the Immersive Reader, to fit the needs of your application.
 
 ## Add the Immersive Reader button
 
-The Immersive Reader SDK provides default styling for the button that launches the Immersive Reader. Use the `immersive-reader-button` class attribute to enable this styling.
+The [Immersive Reader SDK](https://github.com/microsoft/immersive-reader-sdk) provides default styling for the button that launches the Immersive Reader. To enable this styling, use the `immersive-reader-button` class attribute.
 
 ```html
 <div class='immersive-reader-button'></div>
 ```
 
 ## Customize the button style
 
-Use the `data-button-style` attribute to set the style of the button. The allowed values are `icon`, `text`, and `iconAndText`. The default value is `icon`.
+To set the style of the button, use the `data-button-style` attribute. The allowed values are `icon`, `text`, and `iconAndText`. The default value is `icon`.
 
 ### Icon button
 
+Use the following code to render the icon button.
+
 ```html
 <div class='immersive-reader-button' data-button-style='icon'></div>
 ```
 
-This renders the following:
-
-![This is the rendered Text button](./media/button-icon.png)
+:::image type="content" source="media/button-icon.png" alt-text="Screenshot of the rendered button icon.":::
 
 ### Text button
 
+Use the following code to render the button text.
+
 ```html
 <div class='immersive-reader-button' data-button-style='text'></div>
 ```
 
-This renders the following:
-
-![This is the rendered Immersive Reader button.](./media/button-text.png)
+:::image type="content" source="media/button-text.png" alt-text="Screenshot of the text in the button.":::
 
 ### Icon and text button
 
+Use the following code to render both the button and the text.
+
 ```html
 <div class='immersive-reader-button' data-button-style='iconAndText'></div>
 ```
 
-This renders the following:
-
-![Icon button](./media/button-icon-and-text.png)
+:::image type="content" source="media/button-icon-and-text.png" alt-text="Screenshot of the icon and text together.":::
 
 ## Customize the button text
 
-Configure the language and the alt text for the button using the `data-locale` attribute. The default language is English.
+To configure the language and the alt text for the button, use the `data-locale` attribute. The default language is English.
 
 ```html
 <div class='immersive-reader-button' data-locale='fr-FR'></div>
 ```
 
 ## Customize the size of the icon
 
-The size of the Immersive Reader icon can be configured using the `data-icon-px-size` attribute. This sets the size of the icon in pixels. The default size is 20px.
+To configure the size of the Immersive Reader icon, use the `data-icon-px-size` attribute. This sets the size of the icon in pixels. The default size is 20 px.
 
 ```html
 <div class='immersive-reader-button' data-icon-px-size='50'></div>
 ```
 
-## Next steps
+## Next step
 
-* Explore the [Immersive Reader SDK Reference](./reference.md)
+> [!div class="nextstepaction"]
+> [Explore the Immersive Reader SDK reference](reference.md)