Edit procedures

Author: cdpark

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

@@ -6,7 +6,7 @@ author: rwallerms
 manager: nitinme
 ms.service: azure-ai-immersive-reader
 ms.topic: how-to
-ms.date: 02/14/2024
+ms.date: 02/21/2024
 ms.author: rwaller
 ms.custom: devx-track-js, devx-track-extended-java, devx-track-python
 zone_pivot_groups: immersive-reader-how-to-guides

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

@@ -3,7 +3,7 @@ author: rwallerms
 manager: nitinme
 ms.service: azure-ai-immersive-reader
 ms.topic: include
-ms.date: 02/14/2024
+ms.date: 02/21/2024
 ms.author: rwaller
 ---
 
@@ -12,14 +12,25 @@ ms.author: rwaller
 * 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).
+* Clone the [Immersive Reader SDK](https://github.com/microsoft/immersive-reader-sdk) from GitHub.
 * [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 Immersive Reader SDK 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.
+    > [!TIP]
+    > You might need to let the system update the Gradle plugins to at least version 8.
+
+1. To create a new assets folder, right-click on **app** and select **Folder** -> **Assets Folder** from the dropdown.
+
+    :::image type="content" source="../../media/how-tos/android-studio-assets-folder.png" alt-text="Screenshot of the Assets folder option.":::
+
+1. Right-click on **assets** and select **New** -> **File**. Name the file **env**.
+
+    :::image type="content" source="../../media/how-tos/android-studio-create-env-file.png" alt-text="Screenshot of name input field to create the env file.":::
+
+1. 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>

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

@@ -3,7 +3,7 @@ author: rwallerms
 manager: nitinme
 ms.service: azure-ai-immersive-reader
 ms.topic: include
-ms.date: 02/14/2024
+ms.date: 02/21/2024
 ms.author: rwaller
 ---
 
@@ -12,12 +12,12 @@ ms.author: rwaller
 * 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).
+* [Git](https://git-scm.com).
+* Clone the [Immersive Reader SDK](https://github.com/microsoft/immersive-reader-sdk) from GitHub.
 
 ## Configure authentication credentials
 
-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. In Xcode, select **Open Existing Project**. Open the file *immersive-reader-sdk/js/samples/ios/quickstart-swift.xcodeproj*.
 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.
@@ -33,9 +33,9 @@ Don't commit this change into source control because it contains secrets that sh
 
 ## Start the Immersive Reader with sample content
 
-In Xcode, select **Ctrl+R** to run the project.
+In Xcode, select a device simulator, then run the project from the controls or enter **Ctrl+R**.
 
-## Next steps
+## Next step
 
 > [!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,7 +3,7 @@ author: rwallerms
 manager: nitinme
 ms.service: azure-ai-immersive-reader
 ms.topic: include
-ms.date: 02/14/2024
+ms.date: 02/21/2024
 ms.author: rwaller
 ---
 
@@ -32,22 +32,28 @@ yarn add request
 yarn add dotenv
 ```
 
+Install the axios and qs libraries with the following command:
+
+```bash
+npm install axios qs
+```
+
 <a name='acquire-an-azure-ad-authentication-token'></a>
 
-## Acquire a Microsoft Entra authentication token
+## Set up authentication
 
 Next, write a backend API to retrieve a Microsoft Entra authentication token.
 
-You need some values from the Microsoft Entra auth configuration prerequisite step above for this part. Refer back to the text file you saved of that session.
+You need some values from the Microsoft Entra auth configuration prerequisite step for this part. Refer back to the text file you saved from that session.
 
 ````text
 TenantId     => Azure subscription TenantId
-ClientId     => Azure AD ApplicationId
-ClientSecret => Azure AD Application Service Principal password
+ClientId     => Microsoft Entra ApplicationId
+ClientSecret => Microsoft Entra 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.
+Create a new file called *.env* in the root of your project. Paste the following code into it, supplying the values given when you created your Immersive Reader resource. Don't include quotation marks or the `{` and `}` characters.
 
 ```text
 TENANT_ID={YOUR_TENANT_ID}
@@ -56,9 +62,9 @@ CLIENT_SECRET={YOUR_CLIENT_SECRET}
 SUBDOMAIN={YOUR_SUBDOMAIN}
 ```
 
-Be sure not to commit this file into source control, as it contains secrets that should not be made public.
+Be sure not to commit this file into source control, as it contains secrets that shouldn't 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();
@@ -172,15 +178,15 @@ The **getimmersivereaderlaunchparams** API endpoint should be secured behind som
 
 ## 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.
+The Immersive Reader has support for many different languages. You can specify the language of your content by following these steps.
 
 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.
     ```
 
-2. In the JavaScript code, add the following above the call to `ImmersiveReader.launchAsync`. This code passes the Spanish content into the Immersive Reader.
+2. In *views\index.pug*, add the following code above the call to `ImmersiveReader.launchAsync`. This code passes the Spanish content into the Immersive Reader.
 
     ```pug
     content.chunks.push({

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

@@ -3,7 +3,7 @@ author: rwallerms
 manager: nitinme
 ms.service: azure-ai-immersive-reader
 ms.topic: include
-ms.date: 02/14/2024
+ms.date: 02/21/2024
 ms.author: rwaller
 ---
 
@@ -12,10 +12,10 @@ ms.author: rwaller
 * 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.
 * An IDE such as [Visual Studio Code](https://code.visualstudio.com).
+* [Git](https://git-scm.com).
+* Clone the [Immersive Reader SDK](https://github.com/microsoft/immersive-reader-sdk) from GitHub.
 
 You can install the following tools as part of the instructions in this guide:
-* [Git](https://git-scm.com)
-* [Immersive Reader SDK](https://github.com/microsoft/immersive-reader-sdk)
 * [Python](https://www.python.org/downloads/) and [pip](https://docs.python.org/3/installing/index.html). Starting with Python 3.4, pip is included by default with the Python binary installers.
 * [Flask](https://flask.palletsprojects.com/en/2.3.x/)
 * [Jinja](http://jinja.pocoo.org/docs/2.10/)
@@ -24,7 +24,7 @@ You can install the following tools as part of the instructions in this guide:
 
 ## Configure authentication credentials
 
-Create a new file called *.env*, and paste the following names and values into it. Supply the values given when you created your Immersive Reader resource.
+Create a new file called *.env* in the root directory of your project. Paste the following names and values into it. Supply the values given when you created your Immersive Reader resource.
 
 ```text
 TENANT_ID={YOUR_TENANT_ID}
@@ -39,16 +39,6 @@ Secure the **getimmersivereadertoken** API endpoint behind some form of authenti
 
 ## Create a Python web app on Windows
 
-Create a Python web app by using Flask on Windows.
-
-Install [Git](https://git-scm.com).
-
-After Git is installed, open a command prompt and clone the Immersive Reader SDK Git repository to a folder on your computer.
-
-```cmd
-git clone https://github.com/microsoft/immersive-reader-sdk.git
-```
-
 Install [Python](https://www.python.org/downloads/).
 
 Select the **Add Python to PATH** check box, and select **Custom installation**.
@@ -157,24 +147,12 @@ Open your browser, and go to `http://localhost:5000`.
 
 ## Create a Python web app on OSX
 
-Create a Python web app by using Flask on OSX.
-
-Install [Git](https://git-scm.com).
-
-After Git is installed, open Terminal and clone the Immersive Reader SDK Git repository to a folder on your computer.
-
-```bash
-git clone https://github.com/microsoft/immersive-reader-sdk.git
-```
-
 Install [Python](https://www.python.org/downloads/).
 
-The Python root folder, for example, `Python312`, should now be in the Applications folder.
-
-After the Python installation is finished, open Terminal and use `cd` into the Python Scripts folder.
+The Python root folder, for example, `Python312`, should now be in the Applications folder. Open Terminal and use `cd` to go into the Python folder.
 
 ```bash
-cd Python312/Scripts
+cd Python312
 ```
 
 Install pip.
@@ -198,7 +176,8 @@ sudo nano /etc/paths
 - Go to the bottom of the file, and enter the path you want to add as the last item of the list, for example, `PATH=$PATH:/usr/local/bin`.
 - Select **CTRL+X** to quit.
 - Enter **Y** to save the modified buffer.
-- That's it! To test it, in a new Terminal window, enter `echo $PATH`.
+
+That's it! To test it, in a new Terminal window, enter `echo $PATH`.
 
 Install Flask.
 
@@ -282,7 +261,7 @@ To reactivate the environment, run `workon quickstart-python` from the sample pr
 workon quickstart-python
 ```
 
-## Start the Immersive Reader with sample content
+### Start the Immersive Reader with sample content
 
 When the environment is active, run the sample project by entering `flask run` from the sample project root folder.