Freshness pass

Author: cdpark

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

@@ -1,15 +1,15 @@
 ---
 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: sharad-sharma-msft
 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: sharad-sharma-msft
 ---
 
 # How to customize the Immersive Reader button
@@ -30,33 +30,33 @@ Use the `data-button-style` attribute to set the style of the button. The allowe
 
 ### 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
 
@@ -68,12 +68,13 @@ Configure the language and the alt text for the button using the `data-locale` a
 
 ## 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.
+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 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)

articles/ai-services/immersive-reader/how-to-prepare-html.md

@@ -1,23 +1,23 @@
 ---
 title: "How to prepare HTML content for Immersive Reader"
 titleSuffix: Azure AI services
-description: Learn how to launch the Immersive reader using HTML, JavaScript, Python, Android, or iOS. Immersive Reader uses proven techniques to improve reading comprehension for language learners, emerging readers, and students with learning differences.
-author: rwallerms
+description: Learn how to structure HTML and retrieve your content for use with Immersive Reader.
+author: sharad-sharma-msft
 manager: nitinme
 ms.service: azure-ai-immersive-reader
 ms.custom: devx-track-js, devx-track-python
 ms.topic: how-to
-ms.date: 03/04/2021
-ms.author: rwaller
+ms.date: 02/23/2024
+ms.author: sharad-sharma-msft
 ---
 
 # How to prepare HTML content for Immersive Reader
 
-This article shows you how to structure your HTML and retrieve the content, so that it can be used by Immersive Reader.
+This article shows you how to structure your HTML and retrieve the content, so that Immersive Reader can use it.
 
 ## Prepare the HTML content
 
-Place the content that you want to render in the Immersive Reader inside of a container element. Be sure that the container element has a unique `id`. The Immersive Reader provides support for basic HTML elements, see the [reference](reference.md#html-support) for more information.
+Place the content that you want to render in the Immersive Reader inside of a container element. Be sure that the container element has a unique `id`. To learn more about how the Immersive Reader provides support for basic HTML elements, see the [SDK reference](reference.md#html-support).
 
 ```html
 <div id='immersive-reader-content'>
@@ -56,6 +56,7 @@ const data = {
 ImmersiveReader.launchAsync(YOUR_TOKEN, YOUR_SUBDOMAIN, data, YOUR_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-store-user-preferences.md

@@ -1,32 +1,32 @@
 ---
-title: "Store user preferences"
+title: Store user preferences for Immersive Reader
 titleSuffix: Azure AI services
-description: This article will show you how to store the user's preferences.
-author: rwallerms
+description: Learn how to store user preferences via the Immersive Reader SDK options.
+author: sharad-sharma-msft
 manager: nitinme
 
 ms.service: azure-ai-immersive-reader
 ms.topic: how-to
-ms.date: 06/29/2020
-ms.author: rwaller
+ms.date: 02/23/2024
+ms.author: sharad-sharma-msft
 ---
 
 # How to store user preferences
 
-This article demonstrates how to store the user's UI settings, formally known as **user preferences**, via the [-preferences](./reference.md#options) and [-onPreferencesChanged](./reference.md#options) Immersive Reader SDK options.
+This article demonstrates how to store the user's UI settings, or *user preferences*, via the [-preferences](./reference.md#options) and [-onPreferencesChanged](./reference.md#options) Immersive Reader SDK options.
 
-When the [CookiePolicy](./reference.md#cookiepolicy-options) SDK option is set to *Enabled*, the Immersive Reader application stores the **user preferences** (text size, theme color, font, and so on) in cookies, which are local to a specific browser and device. Each time the user launches the Immersive Reader on the same browser and device, it will open with the user's preferences from their last session on that device. However, if the user opens the Immersive Reader on a different browser or device, the settings will initially be configured with the Immersive Reader's default settings, and the user will have to set their preferences again, and so on for each device they use. The `-preferences` and `-onPreferencesChanged` Immersive Reader SDK options provide a way for applications to roam a user's preferences across various browsers and devices, so that the user has a consistent experience wherever they use the application.
+When the [CookiePolicy](./reference.md#cookiepolicy-options) SDK option is set to *Enabled*, the Immersive Reader application stores user preferences, such as text size, theme color, and font, by using cookies. These cookies are local to a specific browser and device. Each time the user launches the Immersive Reader on the same browser and device, it opens with the user's preferences from their last session on that device. However, if the user opens the Immersive Reader app on a different browser or device, the settings are initially configured with the Immersive Reader's default settings, and the user needs to set their preferences again for each device they use. The `-preferences` and `-onPreferencesChanged` Immersive Reader SDK options provide a way for applications to roam a user's preferences across various browsers and devices, so that the user has a consistent experience wherever they use the application.
 
-First, by supplying the `-onPreferencesChanged` callback SDK option when launching the Immersive Reader application, the Immersive Reader will send a `-preferences` string back to the host application each time the user changes their preferences during the Immersive Reader session. The host application is then responsible for storing the user preferences in their own system. Then, when that same user launches the Immersive Reader again, the host application can retrieve that user's preferences from storage, and supply them as the `-preferences` string SDK option when launching the Immersive Reader application, so that the user's preferences are restored.
+First, by supplying the `-onPreferencesChanged` callback SDK option when launching the Immersive Reader application, the Immersive Reader sends a `-preferences` string back to the host application each time the user changes their preferences during the Immersive Reader session. The host application is then responsible for storing the user preferences in their own system. Then, when that same user launches the Immersive Reader again, the host application can retrieve that user's preferences from storage, and supply them as the `-preferences` string SDK option when launching the Immersive Reader application, so that the user's preferences are restored.
 
-This functionality may be used as an alternate means to storing **user preferences** in the case where using cookies is not desirable or feasible.
+This functionality can be used as an alternate means to storing user preferences when using cookies isn't desirable or feasible.
 
 > [!CAUTION]
-> **IMPORTANT** Do not attempt to programmatically change the values of the `-preferences` string sent to and from the Immersive Reader application as this may cause unexpected behavior resulting in a degraded user experience for your customers. Host applications should never assign a custom value to or manipulate the `-preferences` string. When using the `-preferences` string option, use only the exact value that was returned from the `-onPreferencesChanged` callback option.
+> Don't attempt to programmatically change the values of the `-preferences` string sent to and from the Immersive Reader application because this might cause unexpected behavior resulting in a degraded user experience. Host applications should never assign a custom value to or manipulate the `-preferences` string. When using the `-preferences` string option, use only the exact value that was returned from the `-onPreferencesChanged` callback option.
 
-## How to enable storing user preferences
+## Enable storing user preferences
 
-the Immersive Reader SDK [launchAsync](./reference.md#launchasync) `options` parameter contains the `-onPreferencesChanged` callback. This function will be called anytime the user changes their preferences. The `value` parameter contains a string, which represents the user's current preferences. This string is then stored, for that user, by the host application.
+The Immersive Reader SDK [launchAsync](./reference.md#launchasync) `options` parameter contains the `-onPreferencesChanged` callback. This function is called anytime the user changes their preferences. The `value` parameter contains a string, which represents the user's current preferences. This string is then stored, for that user, by the host application.
 
 ```typescript
 const options = {
@@ -38,9 +38,9 @@ const options = {
 ImmersiveReader.launchAsync(YOUR_TOKEN, YOUR_SUBDOMAIN, YOUR_DATA, options);
 ```
 
-## How to load user preferences into the Immersive Reader
+## Load user preferences
 
-Pass in the user's preferences to the Immersive Reader using the `-preferences` option. A trivial example to store and load the user's preferences is as follows:
+Pass in the user's preferences to the Immersive Reader app using the `-preferences` option. A trivial example to store and load the user's preferences is as follows:
 
 ```typescript
 const storedUserPreferences = localStorage.getItem("USER_PREFERENCES");
@@ -54,6 +54,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)