Freshness pass for java and kotlin

Author: cdpark

articles/ai-services/immersive-reader/includes/quickstarts/immersive-reader-client-library-csharp.md

@@ -35,7 +35,7 @@ Create a new project in Visual Studio, using the ASP.NET Core Web Application te
 Right-click on the project in the **Solution Explorer** and choose **Manage User Secrets**. This opens a file called *secrets.json*. This file isn't checked into source control. To learn more, see [Safe storage of app secrets](/aspnet/core/security/app-secrets?tabs=windows). Replace the contents of *secrets.json* with the following, supplying the values given when you created your Immersive Reader resource.
 
 > [!IMPORTANT]
-> Remember to never post secrets publicly. For production, use a secure way of storing and accessing your credentials like [Azure Key Vault](/azure/key-vault/general/overview).
+> Remember to never post secrets publicly. For production, use a secure way of storing and accessing your credentials like [Azure Key Vault](../../../../key-vault/general/overview.md).
 
 ```json
 {

articles/ai-services/immersive-reader/includes/quickstarts/immersive-reader-client-library-java-android.md

@@ -19,49 +19,53 @@ In this quickstart, you build an Android app from scratch and integrate the Imme
 * 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).
 
 ## Create an Android project
 
-Start a new project in Android Studio. Source code for this example is available as part of the [Immersive Reader SDK](https://github.com/microsoft/immersive-reader-sdk/tree/master/js/samples/quickstart-kotlin).
+Start a new project in Android Studio.
 
-![New project - Kotlin](../../media/android/kotlin/android-studio-create-project.png)
+:::image type="content" source="../../media/android/kotlin/android-studio-create-project.png" alt-text="Screenshot of the Start new project option in Android Studio.":::
 
-In the **Choose your project** window, select **Empty Activity**, and then select **Next**.
+In the **Templates** window, select **Empty Views Activity**, and then select **Next**.
 
-![Empty Activity project - Kotlin](../../media/android/kotlin/android-studio-empty-activity.png)
+:::image type="content" source="../../media/android/kotlin/android-studio-empty-activity.png" alt-text="Screenshot of the Templates window in Android Studio.":::
 
 ## Configure the project
 
 Name the project **QuickstartKotlin**, and select a location to save it. Select **Kotlin** as the programming language, and then select **Finish**.
 
-![Configure the project - Kotlin](../../media/android/kotlin/android-studio-configure-project.png)
+:::image type="content" source="../../media/android/kotlin/android-studio-configure-project.png" alt-text="Screenshot of the Configure project window in Android Studio.":::
 
 ## Set up assets and authentication
 
-Create a new **/assets** folder.
+Create a new */assets* folder. Right-click on **app** and select **Folder** -> **Assets Folder** from the dropdown.
 
-![Create a new assets folder - Kotlin](../../media/android/kotlin/android-studio-assets-folder.png)
+:::image type="content" source="../../media/android/kotlin/android-studio-assets-folder.png" alt-text="Screenshot of the Assets folder option.":::
 
- Create a file named **env** inside the assets folder. Add the following names and values, and supply values as appropriate. Don't commit this env file into source control because it contains secrets that shouldn't be made public.
+Right-click on **assets** and select **New** -> **File**. Name the file **env**.
 
-> [!IMPORTANT]
-> Remember to never post secrets publicly. For production, use a secure way of storing and accessing your credentials like [Azure Key Vault](../../../../key-vault/general/overview.md).
+:::image type="content" source="../../media/android/kotlin/android-studio-create-env-file.png" alt-text="Screenshot of name input field to create the env file.":::
 
-![Create a new env file - Kotlin](../../media/android/kotlin/android-studio-create-env-file.png)
+Add the following names and values, and supply values as appropriate. Don't commit this env file into source control because it contains secrets that shouldn't be made public.
 
 ```text
 TENANT_ID=<YOUR_TENANT_ID>
 CLIENT_ID=<YOUR_CLIENT_ID>
 CLIENT_SECRET=<YOUR_CLIENT_SECRET>
 SUBDOMAIN=<YOUR_SUBDOMAIN>
 ```
-![Environment variables in Android Studio - Kotlin](../../media/android/kotlin/android-studio-assets-and-env-file.png)
+
+:::image type="content" source="../../media/android/kotlin/android-studio-assets-and-env-file.png" alt-text="Screenshot of Environment variables in Android Studio.":::
+
+> [!IMPORTANT]
+> Remember to never post secrets publicly. For production, use a secure way of storing and accessing your credentials like [Azure Key Vault](../../../../key-vault/general/overview.md).
 
 ## Add dependencies
 
-Replace the existing dependencies in the **build.gradle** file with the following implementations to enable coroutines (asynchronous programming), gson (JSON parsing and serialization), and dotenv to reference the variables defined in the env file. You might need to sync the project again when you implement MainActivity.kt in a later step in this quickstart.
+Replace the existing dependencies in the *build.gradle* file with the following implementations to enable coroutines (asynchronous programming), gson (JSON parsing and serialization), and dotenv to reference the variables defined in the env file. You might need to sync the project again when you implement *MainActivity.kt* in a later step in this quickstart.
+
+:::image type="content" source="../../media/android/kotlin/android-studio-build-gradle.png" alt-text="Screenshot of app gradle dependencies.":::
 
 ```build.gradle
 dependencies {
@@ -80,13 +84,11 @@ dependencies {
 }
 ```
 
-![App Gradle implementations- Kotlin](../../media/android/kotlin/android-studio-build-gradle.png)
-
 ## Update app strings and layout resources
 
-Replace the content in **res/strings/strings.xml** with the following strings to be used in the app.
+Replace the content in *res/values/strings.xml* with the following strings to be used in the app.
 
-![App strings.xml - Kotlin](../../media/android/kotlin/android-studio-strings.png)
+:::image type="content" source="../../media/android/kotlin/android-studio-strings.png" alt-text="Screenshot of the app strings xml file.":::
 
 ```strings.xml
 <resources>
@@ -102,9 +104,9 @@ Replace the content in **res/strings/strings.xml** with the following strings to
 </resources>
 ```
 
-Replace the content in **res/layout/activity_main.xml** with the following XML to be used in the app. This XML is the UI layout of the app.
+Replace the content in *res/layout/activity_main.xml* with the following XML to be used in the app. This XML is the UI layout of the app. If you don't see the code in the *activity_main.xml* file, right-click on the canvas and select **Go to XML**.
 
-![App activity_main.xml - Kotlin](../../media/android/kotlin/android-studio-activity-main-xml.png)
+:::image type="content" source="../../media/android/kotlin/android-studio-activity-main-xml.png" alt-text="Screenshot of the app activity mail xml file.":::
 
 ```activity_main.xml
 <?xml version="1.0" encoding="utf-8"?>
@@ -203,11 +205,11 @@ Replace the content in **res/layout/activity_main.xml** with the following XML t
 
 ## Set up the app Kotlin code JavaScript interface
 
-In the **/Java/com.example.quickstartkotlin** folder, create a new Kotlin class and name it **WebAppInterface**. Then add the following code to it. This code enables the app to interface with JavaScript functions in HTML that will be added in a later step.
+In the *kotlin+java/com.example.quickstartkotlin/* folder, create a new Kotlin class and name it `WebAppInterface`. Then add the following code to it. This code enables the app to interface with JavaScript functions in HTML that will be added in a later step.
 
-![com.example.quickstartkotlin folder - Kotlin](../../media/android/kotlin/android-studio-com-folder.png)
+:::image type="content" source="../../media/android/kotlin/android-studio-com-folder.png" alt-text="Screenshot of the quickstartkotlin folder.":::
 
-![WebAppInterface - Kotlin](../../media/android/kotlin/android-studio-web-app-interface.png)
+:::image type="content" source="../../media/android/kotlin/android-studio-web-app-interface.png" alt-text="Screenshot of the WebAppInterface Kotlin class.":::
 
 ```WebAppInterface.kt
 // Copyright (c) Microsoft Corporation. All rights reserved.
@@ -258,7 +260,7 @@ class WebAppInterface(private val mContext: Context, var parentLayout: LinearLay
 
 ## Set up the app Kotlin code Main Activity
 
-In the **/Java/com.example.quickstartkotlin** folder, you'll see an existing **MainActivity.kt** Kotlin class file. This file is where the app logic is authored. Replace its contents with the following code:
+In the *kotlin+java/com.example.quickstartkotlin/* folder, there's an existing *MainActivity.kt* Kotlin class file. This file is where the app logic is authored. Replace its contents with the following code.
 
 ```MainActivity.kt
 // Copyright (c) Microsoft Corporation. All rights reserved.
@@ -515,15 +517,17 @@ class MainActivity : AppCompatActivity() {
 }
 ```
 
+You might need to sync the project again.
+
 ## Add the app HTML to the web view
 
-The web view implementation needs HTML to work. Right-click the **/assets** folder, create a new file, and name it **immersiveReader.html**.
+The web view implementation needs HTML to work. Right-click the */assets* folder, create a new file, and name it *immersiveReader.html*.
 
-![Create a new HTML file - Kotlin](../../media/android/kotlin/android-studio-immersive-reader-html.png)
+:::image type="content" source="../../media/android/kotlin/android-studio-immersive-reader-html.png" alt-text="Screenshot of the name input field for the new html file.":::
 
-![HTML asset location - Kotlin](../../media/android/kotlin/android-studio-immersive-reader-html-assets.png)
+:::image type="content" source="../../media/android/kotlin/android-studio-immersive-reader-html-assets.png" alt-text="Screenshot of the html file location in the assets folder.":::
 
-Add the following HTML and JavaScript. This code adds the Immersive Reader SDK to the app and uses it to open the Immersive Reader by using the app code we've written.
+Add the following HTML and JavaScript. This code adds the Immersive Reader SDK to the app and uses it to open the Immersive Reader by using the app code we wrote.
 
 ```immersiveReader.html
 <!-- Copyright (c) Microsoft Corporation. All rights reserved.
@@ -570,9 +574,9 @@ Licensed under the MIT License. -->
 
 ## Set up app permissions
 
-![AndroidManifest - Kotlin](../../media/android/kotlin/android-studio-android-manifest-xml.png)
+Because the application needs to make network calls to the Immersive Reader SDK to function, we need to ensure the app permissions are configured to allow network access. Replace the content of */manifests/AndroidManifest.xml* with the following XML.
 
-Because the application needs to make network calls to the Immersive Reader SDK to function, we need to ensure the app permissions are configured to allow network access. Replace the content of **/manifests/AndroidManifest.xml** with the following XML:
+:::image type="content" source="../../media/android/kotlin/android-studio-android-manifest-xml.png" alt-text="Screenshot of the Android Manifest file.":::
 
 ```AndroidManifest.xml
 <?xml version="1.0" encoding="utf-8"?>
@@ -604,7 +608,7 @@ Because the application needs to make network calls to the Immersive Reader SDK
 
 Use Android Studio to run the app on a device emulator. When you select **Immersive Reader**, the Immersive Reader opens with the content on the app.
 
-![Immersive Reader - Kotlin](../../media/android/kotlin/android-studio-device-emulator.png)
+:::image type="content" source="../../media/android/kotlin/android-studio-device-emulator.png" alt-text="Screenshot of the Immersive Reader app running in the emulator.":::
 
 ## Next step
 

articles/ai-services/immersive-reader/includes/quickstarts/immersive-reader-client-library-kotlin.md

@@ -49,7 +49,7 @@ npm install axios qs
 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.
 
 > [!IMPORTANT]
-> Remember to never post secrets publicly. For production, use a secure way of storing and accessing your credentials like [Azure Key Vault](/azure/key-vault/general/overview).
+> Remember to never post secrets publicly. For production, use a secure way of storing and accessing your credentials like [Azure Key Vault](../../../../key-vault/general/overview.md).
 
 ```text
 TENANT_ID={YOUR_TENANT_ID}