Add nav_order metadata

keveleigh · keveleigh · commit db44ddcdb48e · 2025-11-20T20:24:03.000-08:00
And remove descriptions, as they were mostly duplicative with the title
diff --git a/Pipelines/Scripts/prepare-pages.ps1 b/Pipelines/Scripts/prepare-pages.ps1
@@ -21,6 +21,7 @@ $indexDestination = Join-Path $docs "index.md"
 New-Item -Path $indexDestination -Value @"
 ---
 title: Home
+nav_order: 1
 ---
 
 
diff --git a/docs/mrtk3-overview/api-reference.md b/docs/mrtk3-overview/api-reference.md
@@ -1,6 +1,6 @@
 ---
 title: API reference
-description: MRTK3 API reference
+nav_order: 8
 ---
 
 # API reference — MRTK3
diff --git a/docs/mrtk3-overview/architecture/architecture.md b/docs/mrtk3-overview/architecture/architecture.md
@@ -1,6 +1,6 @@
 ---
 title: Architecture overview
-description: Mixed Reality Toolkit 3 for developers - Architecture overview.
+nav_order: 5
 ---
 
 # Architecture overview — MRTK3
@@ -37,9 +37,3 @@ Conceptually, Unity's Input System will also feel familiar to users of the MRTK2
 ### XR Interaction Toolkit
 
 XRI provides a foundation of interactors and interactables. MRTK builds upon this with its own set of [interactors](interactors.md) and [interactables](interactables.md), allowing for additional features like articulated hand tracking, gaze, and pinch.
-
-## See also
-
-- [Subsystems](subsystems.md)
-- [Interactors](interactors.md)
-- [Interactables](interactables.md)
diff --git a/docs/mrtk3-overview/architecture/interactables.md b/docs/mrtk3-overview/architecture/interactables.md
@@ -1,7 +1,7 @@
 ---
 title: Interactables
-description: Mixed Reality Toolkit 3 for developers - Interactables.
 parent: Architecture overview
+nav_order: 2
 ---
 
 # Interactables — MRTK3
diff --git a/docs/mrtk3-overview/architecture/interactors.md b/docs/mrtk3-overview/architecture/interactors.md
@@ -1,7 +1,7 @@
 ---
 title: Interactor architecture
-description: Mixed Reality Toolkit 3 for developers - Interactor architecture.
 parent: Architecture overview
+nav_order: 1
 ---
 
 # Interactor Architecture — MRTK3
diff --git a/docs/mrtk3-overview/architecture/subsystems.md b/docs/mrtk3-overview/architecture/subsystems.md
@@ -1,7 +1,7 @@
 ---
 title: Subsystems
-description: Mixed Reality Toolkit 3 for developers - Subsystems.
 parent: Architecture overview
+nav_order: 3
 ---
 
 # Subsystems — MRTK3
diff --git a/docs/mrtk3-overview/contributing.md b/docs/mrtk3-overview/contributing.md
@@ -1,6 +1,6 @@
 ---
 title: Contributing to MRTK3
-description: Overview of how to contribute to the MRTK3 open source project.
+nav_order: 6
 ---
 
 # Contributing to MRTK3
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
@@ -1,7 +1,7 @@
 ---
 title: Exploring MRTK3 sample scenes
-description: Using and creating scenes in MRTK3
 parent: Getting started with MRTK3
+nav_order: 1
 ---
 
 # Exploring MRTK3 sample scenes
diff --git a/docs/mrtk3-overview/getting-started/exploring-features/mrtk3-tutorials.md b/docs/mrtk3-overview/getting-started/exploring-features/mrtk3-tutorials.md
@@ -1,19 +1,20 @@
 ---
 title: MRTK3 tutorials
-description: Resources for our MRTK3 tutorials
 parent: Getting started with MRTK3
+nav_order: 2
 ---
 
 # Exploring MRTK3 tutorials
 
 Several tutorials have been created to help developers learn about MRTK3's various features and capabilities.
 
+> [!WARNING]
+> These samples have gone out-of-date and will not be updated.
+
 ## [MRTK3 Aquarium](https://learn.microsoft.com/windows/mixed-reality/develop/unity/mrtk3-aquarium): the in-editor tutorial
 
 The [MRTK3 Aquarium project](https://learn.microsoft.com/windows/mixed-reality/develop/unity/mrtk3-aquarium) provides a Unity in-editor tutorial that explores various MRTK3 features. Set in an underwater scene, you'll be introduced to the creatures of the aquarium and the objects that make up their habitat. Using MRTK3 features, you'll add interactivity to the aquarium, enabling you to create an aquarium of your very own!
 
 ## [Zappy's Playground](https://learn.microsoft.comhttps://learn.microsoft.com/windows/mixed-reality/develop/unity/playground-tutorial)
 
 [Zappy's Playground](https://learn.microsoft.com/windows/mixed-reality/develop/unity/playground-tutorial) is a cross-platform developer sample project that showcases how to develop intuitive and comprehensive end-to-end experiences for mixed reality. It makes use of many advanced features present in MRTK3, such as Gaze Interaction, Hand Menus, and Spatial Audio.
-
-This sample is currently out of date and will be brought up to the current MRTK3 developments in the near future.
diff --git a/docs/mrtk3-overview/getting-started/overview.md b/docs/mrtk3-overview/getting-started/overview.md
@@ -1,6 +1,6 @@
 ---
 title: Getting started with MRTK3
-description: Overview of how to get started with MRTK3
+nav_order: 2
 ---
 
 # Getting started with MRTK3
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
@@ -1,7 +1,7 @@
 ---
-title: Setting up the Development Environment
-description: Setting up the Development Environment
+title: Setting up the development environment
 parent: Getting started with MRTK3
+nav_order: 1
 ---
 
 # Setting up your development environment
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
@@ -1,7 +1,7 @@
 ---
 title: Setting up a new project with MRTK3
-description: Setting up a new project with MRTK3
 parent: Getting started with MRTK3
+nav_order: 3
 ---
 
 # Starting from a new project
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
@@ -1,7 +1,7 @@
 ---
 title: Creating a new scene with MRTK3
-description: Creating a new scene with MRTK3
 parent: Getting started with MRTK3
+nav_order: 4
 ---
 
 # Creating a new scene with MRTK3
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,7 +1,7 @@
 ---
-title: Starting from a Template Project
-description: Setting up your first MRTK3 project
+title: Starting from a template project
 parent: Getting started with MRTK3
+nav_order: 2
 ---
 
 # Starting from the MRTK3 template project
diff --git a/docs/mrtk3-overview/known-issues.md b/docs/mrtk3-overview/known-issues.md
@@ -1,6 +1,6 @@
 ---
 title: Known issues
-description: Mixed Reality Toolkit 3 known issues.
+nav_order: 7
 ---
 
 # Known issues — MRTK3
diff --git a/docs/mrtk3-overview/packages/packages-overview.md b/docs/mrtk3-overview/packages/packages-overview.md
@@ -1,3 +1,8 @@
+---
+title: Packages
+nav_order: 4
+---
+
 # Using MRTK3 packages
 
 Microsoft MRTK3 is distributed as a set of packages that are imported into Unity using the Mixed Reality Feature Tool for Unity and the Unity Package Manager (UPM). These packages enable developers to customize the MRTK within their projects.
@@ -52,8 +57,8 @@ In order to place minimal overhead on applications importing the Mixed Reality T
 | MRTK Environment | org.mixedrealitytoolkit.environment | |
 | MRTK Extended Assets | org.mixedrealitytoolkit.extendedassets | |
 | MRTK Input | org.mixedrealitytoolkit.input |  |
-| MRTK Spatial Manipulation | org.mixedrealitytoolkit.spatialmanipulation | <ul> <li> org.mixedrealitytoolkit.input </li> </ul> |
+| MRTK Spatial Manipulation | org.mixedrealitytoolkit.spatialmanipulation | org.mixedrealitytoolkit.input |
 | MRTK Standard Assets | org.mixedrealitytoolkit.standardassets | |
-| MRTK UX Components | org.mixedrealitytoolkit.uxcomponents | <ul> <li> org.mixedrealitytoolkit.input </li> </ul> |
-| MRTK UX Core | org.mixedrealitytoolkit.uxcore | <ul> <li> org.mixedrealitytoolkit.input </li> </ul> |
+| MRTK UX Components | org.mixedrealitytoolkit.uxcomponents | org.mixedrealitytoolkit.input |
+| MRTK UX Core | org.mixedrealitytoolkit.uxcore | org.mixedrealitytoolkit.input |
 | MRTK Windows Speech | org.mixedrealitytoolkit.windowsspeech | |
diff --git a/docs/mrtk3-overview/release-notes.md b/docs/mrtk3-overview/release-notes.md
diff --git a/docs/mrtk3-overview/test-and-deploy/hololens2-deployment.md b/docs/mrtk3-overview/test-and-deploy/hololens2-deployment.md
@@ -1,7 +1,7 @@
 ---
 title: Deploy an MRTK3 project to HoloLens 2
-description: Mixed Reality Toolkit 3 for developers - HoloLens 2 deployment.
-parent: Test and Experience Overview
+parent: Test and experience overview
+nav_order: 2
 ---
 
 # Deploy an MRTK3 project to HoloLens 2
diff --git a/docs/mrtk3-overview/test-and-deploy/overview.md b/docs/mrtk3-overview/test-and-deploy/overview.md
@@ -1,9 +1,9 @@
 ---
-title: Test and Experience Overview
-description: Overview of how to test and experience your application on a device.
+title: Test and experience overview
+nav_order: 3
 ---
 
-# Testing and experiencing overview
+# Test and experience overview
 
 Now that you have a Unity project with MRTK3, there are several means to test and experience your application.
 
@@ -21,7 +21,7 @@ Compiling and deploying your app can take a significant amount of time, so we re
 
 The following guides will walk you through building and running your application on a device.
 
-- [HoloLens2](hololens2-deployment.md)
+- [HoloLens 2](hololens2-deployment.md)
 - [Quest Devices](quest-deployment.md)
 
 If you've deployed a build to your target device of choice, you can debug the build as it runs on device with [Managed debugging](https://learn.microsoft.com/windows/mixed-reality/develop/unity/managed-debugging-with-unity-il2cpp).
diff --git a/docs/mrtk3-overview/test-and-deploy/quest-deployment.md b/docs/mrtk3-overview/test-and-deploy/quest-deployment.md
@@ -1,7 +1,7 @@
 ---
 title: Deploy an MRTK3 project to a Quest device
-description: Mixed Reality Toolkit 3 for developers - Quest deployment.
-parent: Test and Experience Overview
+parent: Test and experience overview
+nav_order: 3
 ---
 
 # Deploy an MRTK3 project to a Quest device
diff --git a/docs/mrtk3-overview/test-and-deploy/streaming.md b/docs/mrtk3-overview/test-and-deploy/streaming.md
@@ -1,7 +1,7 @@
 ---
 title: Iteration and debugging
-description: Iteration and debugging
-parent: Test and Experience Overview
+parent: Test and experience overview
+nav_order: 1
 ---
 
 # Streaming your application to a device
diff --git a/docs/packages/packages-overview.md b/docs/packages/packages-overview.md
