Rework the "getting started" section

keveleigh · keveleigh · commit 09495483ca0d · 2025-12-04T16:37:47.000-08:00
diff --git a/docs/mrtk3-overview/getting-started/exploring-features/mrtk3-sample-scenes.md b/docs/mrtk3-overview/getting-started/exploring-features/mrtk3-sample-scenes.md
@@ -10,13 +10,13 @@ Unlike MRTK2, MRTK3 isn't distributed as a Unity project. Instead, MRTK3 consist
 
 As a result, we no longer ship our sample scenes inside the MRTK library/package itself. Instead, we maintain the `UnityProjects` folder at the top level of the [GitHub repository](https://github.com/MixedRealityToolkit/MixedRealityToolkit-Unity), which contains any Unity projects we want to ship. Currently, this folder includes the `MRTKDevTemplate` project, which contains all of our example scenes and is configured to align with our recommended best settings.
 
-We also recommend using the `MRTKDevTemplate` project for local development when submitting fixes or changes. All of the packages are specified as local on-disk dependencies, making editing and submitting changes easy. Clone the repo and ensure you're on the `mrtk3` branch, and open the `MRTKDevTemplate` Unity project.
+We also recommend using the `MRTKDevTemplate` project for local development when submitting fixes or changes. All of the packages are specified as local on-disk dependencies, making editing and submitting changes easy. Clone the repo and open the `MRTKDevTemplate` Unity project.
 
 Within `MRTKDevTemplate`, you can find all of our sample scenes. Most of the sample scenes are in `UnityProjects/MRTKDevTemplate/Assets/Scenes`, while some experimental or early-preview sample scenes are located in `UnityProjects/MRTKDevTemplate/Assets/Data Binding Example`.
 
 ## Included sample scenes
 
-We list below just a few of them.
+A non-exhaustive list can be found below.
 
 ### HandInteractionExamples
 
diff --git a/docs/mrtk3-overview/getting-started/overview.md b/docs/mrtk3-overview/getting-started/overview.md
@@ -9,19 +9,8 @@ Welcome to the MRTK3! This guide serves as a starting point for using MRTK to bu
 
 ## Where should I go next?
 
-[Exploring MRTK features](./exploring-features/mrtk3-tutorials.md): Learn about MRTK's features through our tutorial project and explore our example scenes.
+[Explore MRTK features](./exploring-features/mrtk3-sample-scenes.md): Learn about MRTK's features through exploring our example scenes.
 
-[Set up an MRTK Project](./setting-up/setup-dev-env.md): Learn how to create an AR/VR ready Unity project using MRTK
+[Set up an MRTK project](./setting-up/setup-dev-env.md): Learn how to set up your development environment and create an AR/VR ready Unity project using MRTK.
 
-[Test and Deploy your app](../test-and-deploy/overview.md): Learn how to test and deploy your application on a device.
-
-## Software Requirements
-
-To acquire and use MRTK3, the following software tools are required.
-
-| Software | Version | Notes |
-| --- | --- | --- |
-| [Microsoft Visual Studio](https://visualstudio.microsoft.com/) | 2019 Community edition or greater | Recommend Visual Studio 2022 |
-| Unity | 2022.3 LTS or newer | Recommend using an LTS release |
-| [Mixed Reality Feature Tool for Unity](https://aka.ms/mrfeaturetool) | | Used to acquire MRTK3 packages |
-| Mixed Reality OpenXR Plugin | | Install via Mixed Reality Feature Tool |
+[Test and deploy your app](../test-and-deploy/overview.md): Learn how to test and deploy your application on a device.
diff --git a/docs/mrtk3-overview/getting-started/setting-up/setup-dev-env.md b/docs/mrtk3-overview/getting-started/setting-up/setup-dev-env.md
@@ -6,24 +6,35 @@ nav_order: 1
 
 # Setting up your development environment
 
-Before setting up a Unity Project with MRTK3, make sure you have the following prerequisites.
+Before setting up a Unity Project with MRTK3, make sure you have the following software tools installed.
 
-- A Windows 10 or 11 PC
-- Visual Studio 2022 with the required workloads (as noted in the [Installation Checklist](https://learn.microsoft.com/windows/mixed-reality/develop/install-the-tools))
-- Windows 10 SDK 10.0.18362.0 or later
-- Unity Hub with Unity 2022.3 LTS or Unity 2021.3 LTS installed
+| Software | Version | Notes |
+| --- | --- | --- |
+| Unity | 2022.3 LTS or newer | Recommend using an LTS release <br> See [Additional tools](#additional-tools) below for recommended modules |
+| [Mixed Reality Feature Tool for Unity](https://aka.ms/mrfeaturetool) | | Used to acquire MRTK3 packages |
 
-If your target platform is a HoloLens device, your Unity installation needs to include the Universal Windows Platform Support Module.
+## Additional tools
 
-![UWP Module Installation](../../images/setting-up/MRTK-Development-Setup-UWPModule.png)
+### Android
 
-If your target platform is a Quest device, your Unity installation needs to include the Android Build Support Module and its submodules. More more information specifics, see the [Oculus Developer documentation](https://developer.oculus.com/documentation/unity/book-unity-gsg/#install-unity-editor).
+If your target platform is an [AOSP-based](https://source.android.com/) device, like Android XR or Quest, your Unity installation needs to include the Android Build Support module and its submodules.
 
-![Android Module Installation](../../images/setting-up/MRTK-Development-Setup-AndroidModule.png)
+![Android module installation](../../images/setting-up/MRTK-Development-Setup-AndroidModule.png)
+
+### HoloLens 2
+
+| Software | Version | Notes |
+| --- | --- | --- |
+| [Microsoft Visual Studio](https://visualstudio.microsoft.com/) | 2022 Community or newer | Add the required workloads as noted in the [Installation Checklist](https://learn.microsoft.com/windows/mixed-reality/develop/install-the-tools) |
+| Windows 10 SDK | 10.0.18362.0 or later | |
+
+If your target platform is a HoloLens device, your Unity installation needs to include the Universal Windows Platform Support module.
+
+![UWP module installation](../../images/setting-up/MRTK-Development-Setup-UWPModule.png)
 
 ## Next steps
 
 After setting up the development environment, there are few options for creating a Unity Project with MRTK3.
 
-- [Starting from a Template Project](./setup-template.md): This guide walks you through cloning a template project, which is pre-configured to consume all MRTK3 packages. This template project is set up with  Unity project settings for running your application on a device.
-- [Starting from a New Project](./setup-new-project.md): This guide walks you through adding vital MRTK3 packages to a new Unity project. The guide also helps you set up the Unity project settings for running your application on a device.
+- [Starting from the template project](./setup-template.md): This guide walks you through cloning a template project, which is pre-configured to consume all MRTK3 packages. This template project is set up with Unity project settings for running your application on a device.
+- [Starting from a new project](./setup-new-project.md): This guide walks you through adding vital MRTK3 packages to a new Unity project. The guide also helps you set up the Unity project settings for running your application on a device.
diff --git a/docs/mrtk3-overview/getting-started/setting-up/setup-new-project.md b/docs/mrtk3-overview/getting-started/setting-up/setup-new-project.md
@@ -12,34 +12,39 @@ You're not expected to consume every MRTK package. See [which features are usefu
 
 ## Setting up a new Unity project with MRTK3
 
-### 1. Create a new Unity project
+### Create a new Unity project
 
 Create a new Unity project with Unity 2021.3.21f1 or newer. Close the Unity project before proceeding to the next step.
 
-### 2. Import required dependencies and MRTK3 packages with Mixed Reality Feature Tool
+### Import required dependencies and MRTK3 packages with Mixed Reality Feature Tool
 
-There are a handful of packages that MRTK3 uses that aren't part of this toolkit. To obtain these packages, use the [`Mixed Reality Feature Tool`](https://learn.microsoft.com/windows/mixed-reality/develop/unity/welcome-to-mr-feature-tool) and select the latest versions of the following in the **Discover Features** step.
+There are a handful of packages that MRTK3 uses that aren't part of this toolkit. To obtain these packages, use the [Mixed Reality Feature Tool](https://learn.microsoft.com/windows/mixed-reality/develop/unity/welcome-to-mr-feature-tool) and select the latest versions of the following in the **Discover Features** step.
+
+To run on **HoloLens 2** or to visualize controller models on a **Quest device**, an additional package is required:
 
 - **Platform Support → Mixed Reality OpenXR Plugin**
+
+To spatialize audio in your scene, an additional package is required:
+
 - **Spatial Audio → Microsoft Spatializer** (Optional)
 
-For MRTK3 packages, we highly recommend the following two packages to help you get started quickly:
+For MRTK3 packages, we recommend the following two packages to help you get started quickly:
 
 - **MRTK3 → MRTK Input** (Required for this setup)
 - **MRTK3 → MRTK UX Components**
 
 These two packages, along with their dependencies (automatically added by the Feature Tool), will enable you to explore most of our UX offerings and create projects ready to be deployed to various XR devices. You can always come back to the Feature Tool and add more packages to your project later.
 
-Be sure to select the `org.mixedrealitytoolkit.*` packages, and not the deprecated packages. The `com.microsoft.mrtk.*` packages have been deprecated, and are no longer supported.
+Be sure to select the `org.mixedrealitytoolkit.*` packages, and not the deprecated packages. The `com.microsoft.mrtk.*` packages have been deprecated and are no longer supported.
 
 ![Selecting the default MRTK3 packages in Microsoft's Mixed Reality Feature Tool](../../images/mrtk3-featuretool-setup-packages.png)
 
 > [!NOTE]
 > For more information on MRTK3 packages, see the [package overview page](../../packages/packages-overview.md).
 
-When you're finished selecting packages, click **Get features**, and then follow the instructions in the Mixed Reality Feature Tool to import the selected packages into your Unity project.
+When you're finished selecting packages, click **Get Features**, and then follow the instructions in the Mixed Reality Feature Tool to import the selected packages into your Unity project.
 
-### 3. Open the Unity project
+### Open the Unity project
 
 Open the Unity project and wait for Unity to finish importing the newly added packages. There may be two pop-up messages in this process:
 
@@ -48,7 +53,7 @@ Open the Unity project and wait for Unity to finish importing the newly added pa
 
 Unity might restart a few times during this process; wait for it to finish before proceeding.
 
-### 4. Configure MRTK profile after import
+### Configure MRTK profile after import
 
 Once imported, MRTK3 requires a profile to be set for the standalone target platform and each additional target platform.
 
@@ -63,18 +68,14 @@ Once imported, MRTK3 requires a profile to be set for the standalone target plat
 
 1. Switch to the tabs of other build target(s) you want to use (for example, UWP, Android) and check to see if the profile is assigned. If not, repeat the previous step on the current tab.
 
-### 5. Configure OpenXR-related settings
+### Configure OpenXR-related settings
 
 Once imported, MRTK3 requires some configuration on OpenXR if you're targeting a specific XR device. Refer to the instructions on the following pages for platform-specific guidance.
 
 - [Deploy to an Android XR device](../../test-and-deploy/android-xr-deployment.md)
 - [Deploy to a Quest device](../../test-and-deploy/quest-deployment.md)
 - [Deploy to HoloLens 2](../../test-and-deploy/hololens2-deployment.md)
 
-### 6. Congratulations, the project setup is now finished
-
-Proceed to [creating a new MRTK3 scene](./setup-new-scene.md).
-
 ## Next steps
 
-Once you've finished setting up your Unity project, learn how to [experience your application on a device](../../test-and-deploy/overview.md)
+Once you've finished setting up your Unity project, proceed to [creating a new MRTK3 scene](./setup-new-scene.md).
diff --git a/docs/mrtk3-overview/getting-started/setting-up/setup-new-scene.md b/docs/mrtk3-overview/getting-started/setting-up/setup-new-scene.md
@@ -6,17 +6,21 @@ nav_order: 4
 
 # Creating a new scene with MRTK3
 
-The following will walk through through creating a AR/VR ready scene using MRTK3.
+The following will walk through through creating an AR/VR ready scene using MRTK3.
 
 1. Create a new Unity scene.
 1. Add the **MRTK XR Rig** prefab.
-1. Remove the **Main Camera** Game Object because  **MRTK XR Rig** already contains a camera.
+1. Remove the **Main Camera** GameObject because **MRTK XR Rig** already contains a camera.
 
    ![MRTK XR rig screenshot](../../images/mrtk-xr-rig.png)
 
 1. Add the MRTK Input Simulator prefab to your scene.
 
     > [!NOTE]
-    > This step is optional, but required by in-editor simulations.
+    > This step is optional, but required for in-editor input simulation.
 
     ![MRTK input simulator hierarchy pane](../../images/mrtk-input-simulator.png)
+
+## Next steps
+
+Once you've finished setting up your Unity project, learn how to [experience your application on a device](../../test-and-deploy/overview.md).
diff --git a/docs/mrtk3-overview/getting-started/setting-up/setup-template.md b/docs/mrtk3-overview/getting-started/setting-up/setup-template.md
@@ -1,19 +1,25 @@
 ---
-title: Starting from a template project
+title: Starting from the MRTK3 template project
 parent: Getting started with MRTK3
 nav_order: 2
 ---
 
 # Starting from the MRTK3 template project
 
-The easiest way to acquire and try out MRTK3 is to explore our pre-configured project. This project contains references to all of the current MRTK3 packages, and comes pre-configured with the project settings required to deploy to device. Clone the project from [the MRTK3 GitHub repo](https://github.com/MixedRealityToolkit/MixedRealityToolkit-Unity). After that, you can simply launch Unity (2021.3.21f1 or newer) on the `MRTKDevTemplate` project under `UnityProjects` and start playing with the sample scenes in the Editor by using remoting or deploying them to devices.
+The easiest way to acquire and try out MRTK3 is to explore our pre-configured project. This project contains references to all of the current MRTK3 packages and comes pre-configured with the project settings required to deploy to device.
 
-If you work with Git using the command line, you can clone the repo while specifying the `main` branch:
+1. Clone the project from [the MRTK3 GitHub repo](https://github.com/MixedRealityToolkit/MixedRealityToolkit-Unity).
 
- `git clone --branch main https://github.com/MixedRealityToolkit/MixedRealityToolkit-Unity.git`
+    > [!NOTE]
+    > If you work with Git using the command line, you can clone the repo with `git clone https://github.com/MixedRealityToolkit/MixedRealityToolkit-Unity.git`
 
-For information on the sample scenes included in the preview, see [Exploring MRTK3 Sample Scenes](../exploring-features/mrtk3-sample-scenes.md).
+1. Launch Unity (2021.3.21f1 or newer) on the `MRTKDevTemplate` project under `UnityProjects` and start playing with the sample scenes in the Unity editor by using input simulation, remoting, or deploying them to devices.
+
+For information on the sample scenes included in the preview, see [Exploring MRTK3 sample scenes](../exploring-features/mrtk3-sample-scenes.md).
 
 ## Next steps
 
-Once you've finished setting up your Unity project, learn how to [experience your application on a device](../overview.md)
+Once you've finished setting up your Unity project, choose one of the following options:
+
+* Learn how to [experience your application on a device](../../test-and-deploy/overview.md)
+* Proceed to [creating a new MRTK3 scene](./setup-new-scene.md)
diff --git a/docs/mrtk3-overview/test-and-deploy/android-xr-deployment.md b/docs/mrtk3-overview/test-and-deploy/android-xr-deployment.md
@@ -13,7 +13,7 @@ This page describes how to deploy your Unity Project with MRTK3 onto an Android
 
 ## Deployment Prerequisites
 
-1. Add MRTK to your project and ensure your [project settings](../getting-started/setting-up/setup-new-project.md#5-configure-openxr-related-settings) are configured correctly to use the OpenXR pipeline and MRTK's feature set. **These features are required to deploy your project onto your Android XR device**.
+1. Add MRTK to your project and ensure your [project settings](../getting-started/setting-up/setup-new-project.md#configure-openxr-related-settings) are configured correctly to use the OpenXR pipeline and MRTK's feature set. **These features are required to deploy your project onto your Android XR device**.
 
     > [!NOTE]
     > If starting from the [template project](../getting-started/setting-up/setup-template.md), these project settings should already be configured for you.
diff --git a/docs/mrtk3-overview/test-and-deploy/hololens2-deployment.md b/docs/mrtk3-overview/test-and-deploy/hololens2-deployment.md
@@ -13,7 +13,7 @@ This page describes how to deploy your Unity Project with MRTK3 onto a HoloLens
 
 ## Deployment Prerequisites
 
-1. Add MRTK to your project and ensure your [project settings](../getting-started/setting-up/setup-new-project.md#5-configure-openxr-related-settings) are configured correctly to use the OpenXR pipeline and MRTK's feature set. **These features are required to deploy your project onto your HoloLens**.
+1. Add MRTK to your project and ensure your [project settings](../getting-started/setting-up/setup-new-project.md#configure-openxr-related-settings) are configured correctly to use the OpenXR pipeline and MRTK's feature set. **These features are required to deploy your project onto your HoloLens**.
 
     > [!NOTE]
     > If starting from the [template project](../getting-started/setting-up/setup-template.md), these project settings should already be configured for you.
diff --git a/docs/mrtk3-overview/test-and-deploy/quest-deployment.md b/docs/mrtk3-overview/test-and-deploy/quest-deployment.md
@@ -19,7 +19,7 @@ These steps are based around OpenXR as your runtime (i.e. XR plugin provider) as
 
 1. Ensure that [developer mode](https://developer.oculus.com/documentation/native/android/mobile-device-setup/#enable-developer-mode) is enabled on your device (you may need to [join a developer team](https://developers.meta.com/horizon/documentation/native/android/mobile-device-setup/#joining-or-creating-a-team) first). Installing the Oculus ADB Drivers is optional.
 
-1. Add MRTK to your project and ensure that your [project settings](../getting-started/setting-up/setup-new-project.md#5-configure-openxr-related-settings) are configured correctly to use the OpenXR pipeline and MRTK's feature set. **These features are required to deploy your project onto your Quest device**.
+1. Add MRTK to your project and ensure that your [project settings](../getting-started/setting-up/setup-new-project.md#configure-openxr-related-settings) are configured correctly to use the OpenXR pipeline and MRTK's feature set. **These features are required to deploy your project onto your Quest device**.
 
     > [!NOTE]
     > If starting from the [template project](../getting-started/setting-up/setup-template.md), these project settings should already be configured for you.
