Further improvements.

Author: madeline-underwood

content/learning-paths/smartphones-and-mobile/build-android-selfie-app-using-mediapipe-multimodality/2-app-scaffolding.md

@@ -32,16 +32,18 @@ Before you start coding, here are some useful tips:
 2. Select **Empty Views Activity** in the **Phone and Tablet** gallery as Figure 1 shows, then select **Next**.
 ![Empty Views Activity.png alt-text#center](images/2/empty%20project.png "Figure 1: Select Empty Views Activity.")
 
-3. Choose a project name, and select the default configurations as Figure 2 shows. Make sure that the **Language** field is set to **Kotlin**, and **Build configuration language** is set to **Kotlin DSL**.
+3. Choose a project name, and select the default configurations as Figure 2 shows. 
+
+    Make sure that the **Language** field is set to **Kotlin**, and the **Build configuration language** field is set to **Kotlin DSL**.
 ![Project configuration.png alt-text#center](images/2/project%20config.png "Figure 2: Project Configuration.")
 
-## Introduce CameraX dependencies
+## Add CameraX dependencies
 
 [CameraX](https://developer.android.com/media/camera/camerax) is a Jetpack library, built to help make camera app development easier. It provides a consistent, easy-to-use API that works across the vast majority of Android devices with great backward-compatibility.
 
-1. Wait for Android Studio to sync project with Gradle files, this might take several minutes.
+1. Wait for Android Studio to sync project with Gradle files. This might take several minutes.
 
-2. Once the project is synced, navigate to `libs.versions.toml` in your project's root directory as Figure 3 shows. This file serves as the version catalog for all dependencies used in the project.
+2. Once the project is synced, navigate to `libs.versions.toml` in your project's root directory. See Figure 3. This file serves as the version catalog for all dependencies that the project uses.
 
 ![Version Catalog.png alt-text#center](images/2/dependency%20version%20catalog.png "Figure 3: Version Catalog.")
 
@@ -84,7 +86,7 @@ camera-view = { group = "androidx.camera", name = "camera-view", version.ref = "
     }
 ```
 
-2. You should see that a notification appears, as Figure 4 shows. Click **Sync Now** to sync your project.
+2. You should see that a notification appears. See Figure 4. Click **Sync Now** to sync your project.
 
 ![Gradle sync.png alt-text#center](images/2/gradle%20sync.png "Figure 4: Gradle Sync.")
 

content/learning-paths/smartphones-and-mobile/build-android-selfie-app-using-mediapipe-multimodality/3-camera-permission.md

@@ -6,19 +6,15 @@ weight: 3
 layout: learningpathall
 ---
 
-## Run the app on your device
+### Connect your device to your machine with a USB data cable
 
-In this section, you will learn how to run the app on your device.
-
-#### Connect your device to your machine with a USB data cable
-
-If this is your first time running and debugging Android apps, follow the guidance on the Android Developer website [Set up a device for development](https://developer.android.com/studio/run/device#setting-up), and check that you have completed these steps:
+If this is your first time running and debugging Android apps, follow the guidance on the Android Developer website. See [Set up a device for development](https://developer.android.com/studio/run/device#setting-up), and check that you have completed these steps:
 
-1. You have followed the instructions [Enable USB debugging on your device](https://developer.android.com/studio/debug/dev-options#Enable-debugging) from the Android Developer website. 
+1. You have followed the instructions [Enable USB debugging on your device](https://developer.android.com/studio/debug/dev-options#Enable-debugging). 
 
-2. You have confirmed that you have enabled USB debugging by tapping **OK** on your device when the **Allow USB debugging** dialog appears, and that you have checked **Always allow from this computer**, as Figure 6 shows.
+2. You have confirmed that you have enabled USB debugging by tapping **OK** on your device when the **Allow USB debugging** dialog appears, and that you have checked **Always allow from this computer**. See Figure 6.
 
-![AllowUSBDebugging.jpg alt-text#center](https://ftc-docs.firstinspires.org/en/latest/_images/AllowUSBDebugging.jpg) "Figure 6: Allow USB Debugging."
+![AllowUSBDebugging.jpg #center](https://ftc-docs.firstinspires.org/en/latest/_images/AllowUSBDebugging.jpg "Figure 6: Allow USB Debugging.")
 
 
 3. Make sure that your device model name and SDK version correctly show up in the top-right toolbar. 
@@ -36,13 +32,13 @@ If this is your first time running and debugging Android apps, follow the guidan
 2024-11-20 11:43:03.408  2709-3807  PackageManager          pid-2709                             E  Permission android.permission.CAMERA isn't requested by package com.example.holisticselfiedemo
 ```
 
-6. This is the expected behavior from having not yet correctly configured the app's [permissions](https://developer.android.com/guide/topics/permissions/overview). Android OS restricts this app's access to camera features due to privacy constraints.
+This is the expected behavior from having not yet correctly configured the app's permissions. See[Permissions](https://developer.android.com/guide/topics/permissions/overview) on the Android Developer website. Android OS restricts the app's access to camera features due to privacy constraints.
 
-#### Request camera permission at runtime
+### Request camera permission at runtime
 
 1. Navigate to `manifest.xml` in your `app` sub-project's `src/main` path. 
 
-    Declare the camera hardware and set the permissions by inserting the following lines into the `<manifest>` element. Ensure that it is declared outside and above the `<application>` element.
+    Declare the camera hardware, and set the permissions by inserting the following lines into the `<manifest>` element, ensuring that it is declared outside and above the `<application>` element:
 
 ```xml
     <uses-feature
@@ -52,7 +48,7 @@ If this is your first time running and debugging Android apps, follow the guidan
 ```
 
 2. Navigate to `strings.xml` in your `app` sub-project's `src/main/res/values` path.            
-   Insert the following lines of text resources, which you will use at a later stage.
+   Insert the following lines of text resources, which you will use at a later stage:
 
 ```xml
     <string name="permission_request_camera_message">Camera permission is required to recognize face and hands</string>
@@ -77,8 +73,8 @@ If this is your first time running and debugging Android apps, follow the guidan
     }
 ```
 
-5. Add a condition check in `onCreate()` wrapping `setupCamera()` method, to request camera 
-   permission on runtime.
+5. Add a condition check in on the `onCreate()` wrapping `setupCamera()` method, to request camera 
+   permission on runtime:
 
 ```kotlin
         if (!hasPermissions(baseContext)) {
@@ -117,14 +113,16 @@ If this is your first time running and debugging Android apps, follow the guidan
     }
 ```
 
-#### Verify camera permission
+### Verify camera permission
 
 1. Rebuild and run the app. Now you should see a dialog pop up requesting camera permissions. 
 
-2. Depending on your Android OS version, tap **Allow** or **While using the app**(). Then you should see your own face in the camera preview. Good job!  
+2. Depending on your Android OS version, tap **Allow** or **While using the app**(). 
+
+You should then see your own face in the camera preview. Good job!  
 
 {{% notice Tip %}}
-You might need to restart the app to observe the permission change take effect.
+You might need to restart the app to ensure that the permission change takes effect.
 {{% /notice %}}
 
 In the next section, you will learn how to integrate MediaPipe vision solutions. 

content/learning-paths/smartphones-and-mobile/build-android-selfie-app-using-mediapipe-multimodality/4-introduce-mediapipe.md

@@ -14,14 +14,14 @@ MediaPipe Tasks provides the core programming interface of the MediaPipe Solutio
 
 1. Navigate to `libs.versions.toml` and append the following line to the end of the `[versions]` section. 
 
-This defines the version of MediaPipe library that you will be using.
+This defines the version of MediaPipe library that you will be using:
 
 ```toml
 mediapipe-vision = "0.10.15"
 ```
 
 {{% notice Note %}}
-Ensure that you use this version and not newer versions as they might introduce bugs and unexpected behavior.
+Ensure that you use this particular version, and not later versions as they might produce unexpected behavior.
 {{% /notice %}}
 
 2. Append the following lines to the end of the `[libraries]` section. This declares MediaPipe's vision dependency:
@@ -42,7 +42,7 @@ In this app, you will use MediaPipe's [Face Landmark Detection](https://ai.googl
 
 Choose one of the two options below that aligns best with your learning needs.
 
-### Basic approach: manual download
+### 1. Basic approach: manual download
 
 Download the following two files, then move them into the default asset directory `app/src/main/assets`: 
 
@@ -56,15 +56,17 @@ https://storage.googleapis.com/mediapipe-models/gesture_recognizer/gesture_recog
 You might need to create an `assets` directory if you do not have one already.
 {{% /notice %}}
 
-### Advanced approach: configure prebuild download tasks 
+### 2. Advanced approach: configure prebuild download tasks 
 
-Gradle does not come with a convenient [Task](https://docs.gradle.org/current/userguide/tutorial_using_tasks.html) type to manage downloads, so you will use the [gradle-download-task](https://github.com/michel-kraemer/gradle-download-task) dependency.
+As Gradle does not come with a convenient [Task](https://docs.gradle.org/current/userguide/tutorial_using_tasks.html) type to manage downloads, you will need to use the [gradle-download-task](https://github.com/michel-kraemer/gradle-download-task) dependency.
 
 1. Navigate to `libs.versions.toml`. Then:
 
     * Append `download = "5.6.0"` to the `[versions]` section, and append `de-undercouch-download = { id = "de.undercouch.download", version.ref = "download" }  to `[plugins]` section.
 
-2. Navigate to `build.gradle.kts` in your project's `app` directory. Then append `alias(libs.plugins.de.undercouch.download)` to the `plugins` block. This enables the _Download_ task plugin in this `app` subproject.
+2. Navigate to `build.gradle.kts` in your project's `app` directory. Then:
+
+    * Append `alias(libs.plugins.de.undercouch.download)` to the `plugins` block. This enables the _Download_ task plugin in this `app` subproject.
 
 3. Insert the following lines between the `plugins` block and the `android` block to define the constant values, including the asset directory path and the URLs for both models:
 
@@ -99,7 +101,7 @@ tasks.named("preBuild") {
 1. Sync the project again. 
 
 {{% notice Tip %}}
-Refer to [this section](2-app-scaffolding.md#enable-view-binding) if you need help.
+See the previous section [Set up the Development Environment](2-app-scaffolding.md#enable-view-binding), as a reminder on how to do this.
 {{% /notice %}}
 
 2. Now you should see both model asset bundles in your `assets` directory, as shown below:
@@ -110,7 +112,7 @@ Refer to [this section](2-app-scaffolding.md#enable-view-binding) if you need he
 
     Example code is already implemented for ease of use based on [MediaPipe's sample code](https://github.com/google-ai-edge/mediapipe-samples/tree/main/examples). 
 
-    Simply create a new file `HolisticRecognizerHelper.kt` placed in the source directory along with `MainActivity.kt`, then copy and paste the code below into it.
+    Simply create a new file called `HolisticRecognizerHelper.kt`, and place it in the source directory along with `MainActivity.kt`, then copy-and-paste the code below into it:
 
 ```kotlin
 package com.example.holisticselfiedemo
@@ -435,9 +437,9 @@ data class GestureResultBundle(
 ```
 
 {{% notice Info %}}
-The scope of this Learning Path is limited to the recognition of at most one person with two hands in the camera using the MediaPipe vision solutions. 
+The scope of this Learning Path is limited to the recognition of one person with two hands in the camera using the MediaPipe vision solutions. 
 
-If you do want to experiment with a greater number of people, change the `FACES_COUNT` constant to a different value.
+If you would like to experiment with a greater number of people, change the `FACES_COUNT` constant to a higher value.
 {{% /notice %}}
 
 In the next section, you will connect the dots from this helper class to the UI layer through a ViewModel.

content/learning-paths/smartphones-and-mobile/build-android-selfie-app-using-mediapipe-multimodality/_index.md

@@ -6,7 +6,7 @@ minutes_to_complete: 120
 who_is_this_for: This is an introductory topic for mobile application developers interested in learning how to build an Android selfie application with Modern MediaPipe Multimodal AI, Kotlin flows, and CameraX, using the Modern Android Development (MAD) architecture design.
 
 learning_objectives:
-    - Architect a modern Android app focussing on the UI layer.
+    - Architect a modern hands-free selfie Android app with MediaPipe.
     - Leverage lifecycle-aware components within the Model-View-ViewModel (MVVM) architecture.
     - Combine MediaPipe's face landmark detection and gesture recognition for integration in a multimodel selfie solution.
     - Use JetPack CameraX to access camera features.