Freshness pass

Author: cdpark

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

@@ -1,20 +1,20 @@
 ---
 title: "How to launch the Immersive Reader"
 titleSuffix: Azure AI services
-description: Learn how to launch the Immersive reader using JavaScript, Python, Android, or iOS. Immersive Reader uses proven techniques to improve reading comprehension for language learners, emerging readers, and students with learning differences.
+description: Learn how to launch the Immersive reader using JavaScript, Python, Android, or iOS.
 author: rwallerms
 manager: nitinme
 ms.service: azure-ai-immersive-reader
 ms.topic: how-to
-ms.date: 03/04/2021
+ms.date: 02/14/2024
 ms.author: rwaller
 ms.custom: devx-track-js, devx-track-extended-java, devx-track-python
 zone_pivot_groups: immersive-reader-how-to-guides
 ---
 
 # How to launch the Immersive Reader
 
-In the [overview](./overview.md), you learned about what the Immersive Reader is and how it implements proven techniques to improve reading comprehension for language learners, emerging readers, and students with learning differences. This article demonstrates how to launch the Immersive Reader JavaScript, Python, Android, or iOS. 
+In the [overview](./overview.md), you learned about the Immersive Reader and how it implements proven techniques to improve reading comprehension for language learners, emerging readers, and students with learning differences. This article demonstrates how to launch the Immersive Reader using JavaScript, Python, Android, or iOS.
 
 ::: zone pivot="programming-language-javascript"
 

articles/ai-services/immersive-reader/includes/how-to/how-to-launch-immersive-reader-android.md

@@ -3,23 +3,23 @@ author: rwallerms
 manager: nitinme
 ms.service: azure-ai-immersive-reader
 ms.topic: include
-ms.date: 03/04/2021
+ms.date: 02/14/2024
 ms.author: rwaller
 ---
 
 ## Prerequisites
 
-* Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services)
-* An Immersive Reader resource configured for Microsoft Entra authentication. Follow [these instructions](../../how-to-create-immersive-reader.md) to get set up.  You will need some of the values created here when configuring the environment properties. Save the output of your session into a text file for future reference.
-* [Git](https://git-scm.com/).
+* An Azure subscription. You can [create one for free](https://azure.microsoft.com/free/ai-services).
+* An Immersive Reader resource configured for Microsoft Entra authentication. Follow [these instructions](../../how-to-create-immersive-reader.md) to get set up. Save the output of your session into a text file so you can configure the environment properties.
+* [Git](https://git-scm.com).
 * [Immersive Reader SDK](https://github.com/microsoft/immersive-reader-sdk).
 * [Android Studio](https://developer.android.com/studio).
 
 ## Configure authentication credentials
 
-1. Start Android Studio, and open the project from the **immersive-reader-sdk/js/samples/quickstart-java-android** directory (Java) or the **immersive-reader-sdk/js/samples/quickstart-kotlin** directory (Kotlin).
+1. Start Android Studio, and open the project from the *immersive-reader-sdk/js/samples/quickstart-java-android* directory (Java) or the *immersive-reader-sdk/js/samples/quickstart-kotlin* directory (Kotlin).
 
-1. Create a file named **env** inside the **/assets** folder. Add the following names and values, and supply values as appropriate. Don't commit this file into source control because it contains secrets that shouldn't be made public.
+1. Create a file named *.env* inside the **/assets** folder. Add the following names and values, and supply values as appropriate. Don't commit this file into source control because it contains secrets that shouldn't be made public.
 
     ```text
     TENANT_ID=<YOUR_TENANT_ID>
@@ -34,5 +34,5 @@ Choose a device emulator from the AVD Manager, and run the project.
 
 ## Next steps
 
-* Explore the [Immersive Reader SDK](https://github.com/microsoft/immersive-reader-sdk) and the [Immersive Reader SDK reference](../../reference.md).
-* View code samples on [GitHub](https://github.com/microsoft/immersive-reader-sdk/tree/master/js/samples/).
+> [!div class="nextstepaction"]
+> [Explore the Immersive Reader SDK](https://github.com/microsoft/immersive-reader-sdk)

articles/ai-services/immersive-reader/includes/how-to/how-to-launch-immersive-reader-ios.md

@@ -3,22 +3,21 @@ author: rwallerms
 manager: nitinme
 ms.service: azure-ai-immersive-reader
 ms.topic: include
-ms.date: 03/04/2021
+ms.date: 02/14/2024
 ms.author: rwaller
 ---
 
 ## Prerequisites
 
-* Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services)
-* An Immersive Reader resource configured for Microsoft Entra authentication. Follow [these instructions](../../how-to-create-immersive-reader.md) to get set up.  You will need some of the values created here when configuring the environment properties. Save the output of your session into a text file for future reference.
-* [macOS](https://www.apple.com/macos).
+* An Azure subscription. You can [create one for free](https://azure.microsoft.com/free/ai-services).
+* An Immersive Reader resource configured for Microsoft Entra authentication. Follow [these instructions](../../how-to-create-immersive-reader.md) to get set up. Save the output of your session into a text file so you can configure the environment properties.
+* [macOS](https://www.apple.com/macos) and [Xcode](https://apps.apple.com/us/app/xcode/id497799835?mt=12).
 * [Git](https://git-scm.com/).
 * [Immersive Reader SDK](https://github.com/microsoft/immersive-reader-sdk).
-* [Xcode](https://apps.apple.com/us/app/xcode/id497799835?mt=12).
 
 ## Configure authentication credentials
 
-1. Open Xcode, and open **immersive-reader-sdk/js/samples/ios/quickstart-swift/quickstart-swift.xcodeproj**.
+1. Open Xcode, and open the *immersive-reader-sdk/js/samples/ios/quickstart-swift* directory or the *immersive-reader-sdk/js/samples/ios/quickstart-swift.xcodeproj* directory.
 1. On the top menu, select **Product** > **Scheme** > **Edit Scheme**.
 1. In the **Run** view, select the **Arguments** tab.
 1. In the **Environment Variables** section, add the following names and values. Supply the values given when you created your Immersive Reader resource.
@@ -38,5 +37,5 @@ In Xcode, select **Ctrl+R** to run the project.
 
 ## Next steps
 
-* Explore the [Immersive Reader SDK](https://github.com/microsoft/immersive-reader-sdk) and the [Immersive Reader SDK reference](../../reference.md).
-* View code samples on [GitHub](https://github.com/microsoft/immersive-reader-sdk/tree/master/js/samples/).
+> [!div class="nextstepaction"]
+> [Explore the Immersive Reader SDK](https://github.com/microsoft/immersive-reader-sdk)

articles/ai-services/immersive-reader/includes/how-to/how-to-launch-immersive-reader-nodejs.md

@@ -3,16 +3,16 @@ author: rwallerms
 manager: nitinme
 ms.service: azure-ai-immersive-reader
 ms.topic: include
-ms.date: 03/04/2021
+ms.date: 02/14/2024
 ms.author: rwaller
 ---
 
 ## Prerequisites
 
-* Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services)
-* An Immersive Reader resource configured for Microsoft Entra authentication. Follow [these instructions](../../how-to-create-immersive-reader.md) to get set up.  You will need some of the values created here when configuring the environment properties. Save the output of your session into a text file for future reference.
-* [Node.js](https://nodejs.org/) and [Yarn](https://yarnpkg.com)
-* An IDE such as [Visual Studio Code](https://code.visualstudio.com/)
+* An Azure subscription. You can [create one for free](https://azure.microsoft.com/free/ai-services).
+* An Immersive Reader resource configured for Microsoft Entra authentication. Follow [these instructions](../../how-to-create-immersive-reader.md) to get set up. Save the output of your session into a text file so you can configure the environment properties.
+* [Node.js](https://nodejs.org) and [Yarn](https://yarnpkg.com).
+* An IDE such as [Visual Studio Code](https://code.visualstudio.com).
 
 ## Create a Node.js web app with Express
 
@@ -24,7 +24,7 @@ express --view=pug myapp
 cd myapp
 ```
 
-Install yarn dependencies, and add dependencies `request` and `dotenv`, which will be used later in the tutorial.
+Install yarn dependencies, and add dependencies `request` and `dotenv`, which are used later in the tutorial.
 
 ```bash
 yarn
@@ -47,7 +47,7 @@ ClientSecret => Azure AD Application Service Principal password
 Subdomain    => Immersive Reader resource subdomain (resource 'Name' if the resource was created in the Azure portal, or 'CustomSubDomain' option if the resource was created with Azure CLI PowerShell. Check the Azure portal for the subdomain on the Endpoint in the resource Overview page, for example, 'https://[SUBDOMAIN].cognitiveservices.azure.com/')
 ````
 
-Once you have these values, create a new file called _.env_, and paste the following code into it, supplying your custom property values from above. Do not include quotation marks or the "{" and "}" characters.
+Once you have these values, create a new file called *.env*, and paste the following code into it, supplying your custom property values from above. Do not include quotation marks or the "{" and "}" characters.
 
 ```text
 TENANT_ID={YOUR_TENANT_ID}
@@ -58,13 +58,13 @@ SUBDOMAIN={YOUR_SUBDOMAIN}
 
 Be sure not to commit this file into source control, as it contains secrets that should not be made public.
 
-Next, open _app.js_ and add the following to the top of the file. This loads the properties defined in the .env file as environment variables into Node.
+Next, open *app.js* and add the following to the top of the file. This loads the properties defined in the .env file as environment variables into Node.
 
 ```javascript
 require('dotenv').config();
 ```
 
-Open the _routes\index.js_ file and replace its content with the following code.
+Open the *routes\index.js* file and replace its content with the following code.
 
 This code creates an API endpoint that acquires a Microsoft Entra authentication token using your service principal password. It also retrieves the subdomain. It then returns an object containing the token and subdomain.
 
@@ -111,14 +111,14 @@ The **getimmersivereaderlaunchparams** API endpoint should be secured behind som
 
 ## Launch the Immersive Reader with sample content
 
-1. Open _views\layout.pug_, and add the following code under the `head` tag, before the `body` tag. These `script` tags load the [Immersive Reader SDK](https://github.com/microsoft/immersive-reader-sdk) and jQuery.
+1. Open *views\layout.pug*, and add the following code under the `head` tag, before the `body` tag. These `script` tags load the [Immersive Reader SDK](https://github.com/microsoft/immersive-reader-sdk) and jQuery.
 
     ```pug
     script(src='https://ircdname.azureedge.net/immersivereadersdk/immersive-reader-sdk.1.2.0.js')
     script(src='https://code.jquery.com/jquery-3.3.1.min.js')
     ```
 
-2. Open _views\index.pug_, and replace its content with the following code. This code populates the page with some sample content, and adds a button that launches the Immersive Reader.
+2. Open *views\index.pug*, and replace its content with the following code. This code populates the page with some sample content, and adds a button that launches the Immersive Reader.
 
     ```pug
     extends layout
@@ -168,13 +168,13 @@ The **getimmersivereaderlaunchparams** API endpoint should be secured behind som
     npm start
     ```
 
-4. Open your browser and navigate to _http://localhost:3000_. You should see the above content on the page. Select the **Immersive Reader** button to launch the Immersive Reader with your content.
+4. Open your browser and navigate to <http://localhost:3000>. You should see the above content on the page. Select the **Immersive Reader** button to launch the Immersive Reader with your content.
 
 ## Specify the language of your content
 
 The Immersive Reader has support for many different languages. You can specify the language of your content by following the steps below.
 
-1. Open _views\index.pug_ and add the following code below the `p(id=content)` tag that you added in the previous step. This code adds some content Spanish content to your page.
+1. Open *views\index.pug* and add the following code below the `p(id=content)` tag that you added in the previous step. This code adds some content Spanish content to your page.
 
     ```pug
     p(id='content-spanish') El estudio de las formas terrestres de la Tierra se llama geografía física. Los accidentes geográficos pueden ser montañas y valles. También pueden ser glaciares, lagos o ríos.
@@ -189,13 +189,13 @@ The Immersive Reader has support for many different languages. You can specify t
     });
     ```
 
-3. Navigate to _http://localhost:3000_ again. You should see the Spanish text on the page, and when you select **Immersive Reader**, it will show up in the Immersive Reader as well.
+3. Navigate to <http://localhost:3000> again. You should see the Spanish text on the page, and when you select **Immersive Reader**, it shows up in the Immersive Reader as well.
 
 ## Specify the language of the Immersive Reader interface
 
 By default, the language of the Immersive Reader interface matches the browser's language settings. You can also specify the language of the Immersive Reader interface with the following code.
 
-1. In _views\index.pug_, replace the call to `ImmersiveReader.launchAsync(token, subdomain, content)` with the code below.
+1. In *views\index.pug*, replace the call to `ImmersiveReader.launchAsync(token, subdomain, content)` with the following code.
 
     ```javascript
     const options = {
@@ -204,13 +204,13 @@ By default, the language of the Immersive Reader interface matches the browser's
     ImmersiveReader.launchAsync(token, subdomain, content, options);
     ```
 
-2. Navigate to _http://localhost:3000_. When you launch the Immersive Reader, the interface will be shown in French.
+2. Navigate to <http://localhost:3000>. When you launch the Immersive Reader, the interface is shown in French.
 
 ## Launch the Immersive Reader with math content
 
 You can include math content in the Immersive Reader by using [MathML](https://developer.mozilla.org/en-US/docs/Web/MathML).
 
-1. Modify _views\index.pug_ to include the following code above the call to `ImmersiveReader.launchAsync`:
+1. Modify *views\index.pug* to include the following code above the call to `ImmersiveReader.launchAsync`:
 
     ```javascript
     const mathML = '<math xmlns="https://www.w3.org/1998/Math/MathML" display="block"> \
@@ -235,9 +235,9 @@ You can include math content in the Immersive Reader by using [MathML](https://d
     });
     ```
 
-2. Navigate to _http://localhost:3000_. When you launch the Immersive Reader and scroll to the bottom, you'll see the math formula.
+2. Navigate to <http://localhost:3000>. When you launch the Immersive Reader and scroll to the bottom, you'll see the math formula.
 
-## Next steps
+## Next step
 
-* Explore the [Immersive Reader SDK](https://github.com/microsoft/immersive-reader-sdk) and the [Immersive Reader SDK Reference](../../reference.md)
-* View code samples on [GitHub](https://github.com/microsoft/immersive-reader-sdk/tree/master/js/samples/advanced-csharp)
+> [!div class="nextstepaction"]
+> [Explore the Immersive Reader SDK](https://github.com/microsoft/immersive-reader-sdk)