Merge pull request #50831 from ShawnKupfer/WB1810

JamesJBarnett · web-flow · commit def6254d23cc · 2025-06-11T13:31:52.000-07:00
AB#1055081: Getting started with 3D object interaction
diff --git a/learn-pr/azure/get-started-with-object-interaction/5-1-introduction.yml b/learn-pr/azure/get-started-with-object-interaction/5-1-introduction.yml
@@ -4,9 +4,9 @@ title: Introduction
 metadata:
   title: Introduction
   description: Introduction
-  ms.date: 06/26/2023
+  ms.date: 06/05/2025
   author: marlenaklein-msft
-  ms.author: marlenaklein
+  ms.author: lolab
   ms.topic: unit
 durationInMinutes: 2
 content: |
diff --git a/learn-pr/azure/get-started-with-object-interaction/5-2-panel-of-buttons-dynamic-menus.yml b/learn-pr/azure/get-started-with-object-interaction/5-2-panel-of-buttons-dynamic-menus.yml
@@ -4,9 +4,9 @@ title: Panel of buttons and dynamic menus
 metadata:
   title:  Panel of buttons and dynamic menus
   description: Introduction for  Panel of buttons and dynamic menus
-  ms.date: 06/26/2023
+  ms.date: 06/05/2025
   author: marlenaklein-msft
-  ms.author: marlenaklein
+  ms.author: lolab
   ms.topic: unit
 durationInMinutes: 5
 content: |
diff --git a/learn-pr/azure/get-started-with-object-interaction/5-3-exercise-panel-of-buttons-menus.yml b/learn-pr/azure/get-started-with-object-interaction/5-3-exercise-panel-of-buttons-menus.yml
@@ -4,9 +4,9 @@ title: Exercise - Panel of buttons and dynamic menus
 metadata:
   title: Exercise - Panel of buttons and dynamic menus
   description: Introduction for  Panel of buttons and dynamic menus
-  ms.date: 06/26/2023
+  ms.date: 06/05/2025
   author: marlenaklein-msft
-  ms.author: marlenaklein
+  ms.author: lolab
   ms.topic: unit
 durationInMinutes: 10
 content: |
diff --git a/learn-pr/azure/get-started-with-object-interaction/5-4-provide-description-to-objects-using-text-on-scene-tooltips.yml b/learn-pr/azure/get-started-with-object-interaction/5-4-provide-description-to-objects-using-text-on-scene-tooltips.yml
@@ -4,9 +4,9 @@ title: Provide description to objects using text on scene
 metadata:
   title:  Provide description to objects using text on scene
   description: Introduction for Provide description to objects using text on scene
-  ms.date: 06/26/2023
+  ms.date: 06/05/2025
   author: marlenaklein-msft
-  ms.author: marlenaklein
+  ms.author: lolab
   ms.topic: unit
 durationInMinutes: 5
 content: |
diff --git a/learn-pr/azure/get-started-with-object-interaction/5-5-exercise-provide-description-to-objects-using-text-on-scene-tooltips.yml b/learn-pr/azure/get-started-with-object-interaction/5-5-exercise-provide-description-to-objects-using-text-on-scene-tooltips.yml
@@ -4,9 +4,9 @@ title: Exercise - Provide description to objects using text on scene
 metadata:
   title: Exercise - Provide description to objects using text on scene
   description: Introduction for Provide description to objects using text on scene
-  ms.date: 06/26/2023
+  ms.date: 06/05/2025
   author: marlenaklein-msft
-  ms.author: marlenaklein
+  ms.author: lolab
   ms.topic: unit
 durationInMinutes: 10
 content: |
diff --git a/learn-pr/azure/get-started-with-object-interaction/5-6-manipulate-3d-objects-with-bounds-control.yml b/learn-pr/azure/get-started-with-object-interaction/5-6-manipulate-3d-objects-with-bounds-control.yml
@@ -4,9 +4,9 @@ title: Manipulate 3D objects using bounds control
 metadata:
   title:  Manipulate 3D objects using bounds control
   description: Introduction for Manipulate 3D objects using bounds control
-  ms.date: 06/26/2023
+  ms.date: 06/05/2025
   author: marlenaklein-msft
-  ms.author: marlenaklein
+  ms.author: lolab
   ms.topic: unit
 durationInMinutes: 5
 content: |
diff --git a/learn-pr/azure/get-started-with-object-interaction/5-7-exercise-manipulate-3d-objects-with-bounds-control.yml b/learn-pr/azure/get-started-with-object-interaction/5-7-exercise-manipulate-3d-objects-with-bounds-control.yml
@@ -5,9 +5,9 @@ title: Exercise - Manipulate 3D objects using bounds control
 metadata:
   title: Exercise - Manipulate 3D objects using bounds control
   description: Introduction for Manipulate 3D objects using bounds control
-  ms.date: 06/26/2023
+  ms.date: 06/05/2025
   author: marlenaklein-msft
-  ms.author: marlenaklein
+  ms.author: lolab
   ms.topic: unit
 durationInMinutes: 10
 content: |
diff --git a/learn-pr/azure/get-started-with-object-interaction/5-8-knowledge-check.yml b/learn-pr/azure/get-started-with-object-interaction/5-8-knowledge-check.yml
@@ -4,36 +4,36 @@ title: Module assessment
 metadata:
   title: Module assessment
   description: Two multiple-choice questions
-  ms.date: 06/26/2023
+  ms.date: 06/05/2025
   author: marlenaklein-msft
-  ms.author: marlenaklein
+  ms.author: lolab
   ms.topic: unit
 durationInMinutes: 3
 content: Choose the best response for each question. 
 quiz:
   title: Check your knowledge
   questions:
-    - content: " What is the purpose of the ObjectManipulator script?"
+    - content: "What's the purpose of the `ObjectManipulator` script?"
       choices:
         - content: "This script makes an object movable, scalable, and rotatable using one or two hands."
           isCorrect: true
-          explanation: The ObjectManipulator script makes an object movable, scalable, and rotatable using one or two hands.
+          explanation: "The `ObjectManipulator` script makes an object movable, scalable, and rotatable using one or two hands."
         - content: "This script helps outline the game object for bodily collisions."
           isCorrect: false
           explanation: Collider component helps approximate the object's mesh and is added to any GameObject that can be manipulated.
         - content: "This script makes an object change color when a user gazes at the object."
           isCorrect: false
-          explanation: You must enable eye-tracking to do the above operation.
+          explanation: You must enable eye-tracking to do that.
     - content: "Which component is an all-in-one container to make any object easily interactable and responsive to input?"
       choices:
         - content: "Box Collider Component"
           isCorrect: false
           explanation: Box Colliders are rectangular cuboid and are useful for items such as crates or chests.
         - content: "Bounds Control Component"
           isCorrect: false
-          explanation: This script helps display a bounding box across a hologram to suggest it can be interacted with.
+          explanation: This script helps display a bounding box across a hologram to suggest the user can interact with it.
         - content: "StatefulInteractable Component"
           isCorrect: true
           explanation: StatefulInteractable acts as a catch-all for all types of input including touch, hand rays, speech, and funnel these interactions into events and visual theme responses.
  
-    
+    
diff --git a/learn-pr/azure/get-started-with-object-interaction/5-9-summary.yml b/learn-pr/azure/get-started-with-object-interaction/5-9-summary.yml
@@ -4,9 +4,9 @@ title: Summary
 metadata:
   title: Summary
   description: Summary of interacting with 3D objects
-  ms.date: 06/26/2023
+  ms.date: 06/05/2025
   author: marlenaklein-msft
-  ms.author: marlenaklein
+  ms.author: lolab
   ms.topic: unit
 durationInMinutes: 4
 content: |
diff --git a/learn-pr/azure/get-started-with-object-interaction/includes/5-1-introduction.md b/learn-pr/azure/get-started-with-object-interaction/includes/5-1-introduction.md
@@ -1,4 +1,4 @@
-The key to the success of an application lies in its user interface. It's the first link between your system and the user; creating a robust user interface will influence the other users who need your application. 
+The key to an application's success lies in its user interface. It's the first link between your system and the user, and creating a robust user interface will influence the other users who need your application.
 
 Let's suppose you're working at a tech company in the UI/UX designing team. Your company is planning to launch a holographic application. Your job is to improve the application's user experience (UX) by providing components that will assist the user in better interaction with holograms.
 
@@ -7,6 +7,6 @@ This module shows you how to build a mixed reality user experience with MRTK usi
 * Create a basic user interface using MRTK's button and menu prefabs.
 * Add bounds control around 3D objects
 
-By the end of the module, you can create and edit UI elements for your project using MRTK.
+By the end of the module, you'll be able to create and edit UI elements for your project using MRTK.
 
-A completed example of this tutorial can be found [here](https://github.com/microsoft/MixedRealityLearning/tree/development/MRTK3%20Tutorials).
+You can find a completed example of this tutorial [here](https://github.com/microsoft/MixedRealityLearning/tree/development/MRTK3%20Tutorials).
diff --git a/learn-pr/azure/get-started-with-object-interaction/includes/5-2-panel-of-buttons-dynamic-menus.md b/learn-pr/azure/get-started-with-object-interaction/includes/5-2-panel-of-buttons-dynamic-menus.md
@@ -1,7 +1,7 @@
 ## UI buttons
 
-Buttons help the user to trigger an immediate action. It's one of the foundational components provided by MRTK. Various kinds of button prefabs can be used, depending on your situation. The Button is based on the StatefulInteractable script component to offer smooth UI controls on different interactive surfaces. The StatefulInteractable component is an all-in-one box to make any item interactable. StatefulInteractable acts as a catch-all, considering all forms of entering consisting of touch, hand rays, speech, and so on, and funnels those interactions into activities and visible subject responses.
+Buttons help the user to trigger an immediate action. It's one of the foundational components MRTK provides. You can use various kinds of button prefabs, depending on your situation. The Button is based on the `StatefulInteractable` script component to offer smooth UI controls on different interactive surfaces. The `StatefulInteractable` component is an all-in-one box to make any item interactable. `StatefulInteractable` acts as a catch-all, considering all forms of entering consisting of touch, hand rays, speech, and so on, and funnels those interactions into activities and visible subject responses.
 
 ## UI menu
 
-Menu is a UX control, which offers a set of buttons or different UI components. It's floating across the user's frame and effortlessly available anytime. Since it's loosely coupled with the person, it no longer disturbs the user's interplay with the target content. The user can use the 'Pin' button to world-lock/unlock the menu. The menu may be grabbed at a selected position and relocated to a selected position.
+Menu is a UX control, which offers a set of buttons or different UI components. It's floating across the user's frame and effortlessly available anytime. Because it's loosely coupled to the person, it no longer disturbs the user's interplay with the target content. The user can use the 'Pin' button to world-lock/unlock the menu. The user can grab the menu at a selected position and relocate it to a selected position.
diff --git a/learn-pr/azure/get-started-with-object-interaction/includes/5-3-exercise-panel-of-buttons-menus.md b/learn-pr/azure/get-started-with-object-interaction/includes/5-3-exercise-panel-of-buttons-menus.md
@@ -41,56 +41,56 @@ There are several ways to provide inputs. Inputs trigger certain events and perf
 
     :::image type="content" source="../media/explode-button-object.png" alt-text="Screenshot of Unity with Explode button object OnClick event configured." lightbox="../media/explode-button-object.png":::
 
-7. Press the Play button to enter Game mode. Press-and-hold the space bar to activate the hand and use the mouse to press the **Hints** button to toggle the visibility of the placement hint objects:
+7. Press the **Play** button to enter Game mode. Press and hold the space bar to activate the hand, then use the mouse to press the **Hints** button to toggle the visibility of the placement hint objects:
 
     :::image type="content" source="../media/hint-button-pressed.png" alt-text="Screenshot of Unity Play mode split view with Hints button being pressed." lightbox="../media/hint-button-pressed.png":::
 
-8. **Explode button** will toggle the exploded view on and off:
+8. **Explode button** toggles the exploded view on and off:
 
     :::image type="content" source="../media/explode-button-pressed.png" alt-text="Screenshot of Unity Play mode split view with Explode button being pressed." lightbox="../media/explode-button-pressed.png":::
 
-    We will implement the **Reset** button later in the module.
+    We'll implement the **Reset** button later in the module.
 
 ## Create a dynamic menu that follows the user
 
 1. In the Project pane, navigate to the **Packages** > **MRTK UX Components** > **Near Menu** folder, click-and-drag the **NearMenuBase** prefab into the Hierarchy window, set its Transform **Position** to X = 0, Y = -0.4, Z = 0 and configure it as follows:
-    * Verify that the **SolverHandler** component's **Tracked Target Type** is set to **Head**
-    * Check the checkbox next to the **RadialView** Solver component so it's enabled by default
+    * Verify that the **SolverHandler** component's **Tracked Target Type** is set to **Head**.
+    * Check the checkbox next to the **RadialView** Solver component so it's enabled by default.
 
     :::image type="content" source="../media/near-menu-prefab.png" alt-text="Screenshot of Unity with newly added near menu prefab selected." lightbox="../media/near-menu-prefab.png":::
 
 2. In the Hierarchy window, rename the object to **Menu**, then expand its **MenuContent-HorizontalLayout (Menu and Pin) > Buttons-GridLayout (Buttons)** child object to reveal the three buttons:
 
     :::image type="content" source="../media/menu-object-selected.png" alt-text="Screenshot of Unity with Menu object selected and ButtonCollection object expanded." lightbox="../media/menu-object-selected.png":::
 
-3. Rename the first button in the Buttons-GridLayout (Buttons) to Indicator, then in the Hierarchy window, configure the Indicator game object as follows:
+3. Rename the first button in the **Buttons-GridLayout (Buttons)** to **Indicator**, then in the Hierarchy window, configure the **Indicator** game object as follows:
 
-    * Select the **Frontplate > AnimatedContent > Icon > Label** object and change the **TextMesh Pro** component to match the name of the button. Make sure the Label object is activated in the hierarchy
-    * Configure the **PressableButton.OnClicked()** event by assigning the **Indicator** object that looks like a chevron, to the **None (Object)** field and selecting **GameObject > SetActive (bool)** from the **No Function** dropdown (verify that the argument checkbox is **checked**)
-    * Select the **Frontplate > AnimatedContent > Icon > UIButtonFontIcon** object and change the icon to the search icon on the **Font Icon Selector** component. You can find this in the list of icons, or set **Current Icon Name** to 'Icon 130'
+    * Select the **Frontplate > AnimatedContent > Icon > Label** object and change the **TextMesh Pro** component to match the name of the button. Make sure the Label object is activated in the hierarchy.
+    * Configure the **PressableButton.OnClicked()** event by assigning the **Indicator** object that looks like a chevron, to the **None (Object)** field and selecting **GameObject > SetActive (bool)** from the **No Function** dropdown (verify that the argument checkbox is **checked**).
+    * Select the **Frontplate > AnimatedContent > Icon > UIButtonFontIcon** object and change the icon to the search icon on the **Font Icon Selector** component. You can find this in the list of icons, or set **Current Icon Name** to **Icon 130**.
 
     :::image type="content" source="../media/indicator-button-object.png" alt-text="Screenshot of Unity with Indicator button object Button Config Helper configured." lightbox="../media/indicator-button-object.png":::
 
 4. To disable the chevron Indicator object, in the Hierarchy pane, select the Indicator object that looks like a chevron, then in the Inspector pane:
 
-    * Clear the checkbox next to its name to make it inactive by default
-    * Use the **Add Component** button to add the **Directional Indicator Controller (Script)** component
+    * Clear the checkbox next to its name to make it inactive by default.
+    * Use the **Add Component** button to add the **Directional Indicator Controller (Script)** component.
 
     :::image type="content" source="../media/directional-indicator-controller.png" alt-text="Screenshot of Unity with Indicator object selected, disabled, and DirectionalIndicatorController component added." lightbox="../media/directional-indicator-controller.png":::
 
-5. Rename the second button to **TapToPlace**, then in the Hierarchy window, configure the TapToPlace game object as follows:
+5. Rename the second button to **TapToPlace**, then configure the **TapToPlace** game object in the Hierarchy window as follows:
 
-    * Select the **Frontplate > AnimatedContent > Icon > Label** object and change the **TextMesh Pro** component to match the name of the button. Make sure the Label object is activated in the hierarchy
-    * Configure the **PressableButton.OnClicked()** event by assigning the RoverExplorer > **RoverAssembly** object to the **None (Object)** field and selecting **TapToPlace** > **bool Enabled** from the **No Function** dropdown (verify that the argument checkbox is **checked**)
-    * Select the **Frontplate > AnimatedContent > Icon > UIButtonFontIcon** object and change the icon to the hand icon on the **Font Icon Selector** component. You can find this in the list of icons, or set **Current Icon Name** to 'Icon 13'
+    * Select the **Frontplate > AnimatedContent > Icon > Label** object and change the **TextMesh Pro** component to match the name of the button. Make sure the Label object is activated in the hierarchy.
+    * Configure the **PressableButton.OnClicked()** event by assigning the RoverExplorer > **RoverAssembly** object to the **None (Object)** field and selecting **TapToPlace** > **bool Enabled** from the **No Function** dropdown (verify that the argument checkbox is **checked**).
+    * Select the **Frontplate > AnimatedContent > Icon > UIButtonFontIcon** object and change the icon to the hand icon on the **Font Icon Selector** component. You can find this in the list of icons, or set **Current Icon Name** to **Icon 13**.
 
     :::image type="content" source="../media/tap-to-place-button.png" alt-text="Screenshot of Unity with TapToPlace button object Button Config Helper configured." lightbox="../media/tap-to-place-button.png":::
 
 6. In the Hierarchy window, select the **RoverAssembly** object, then in the Inspector window, configure the **Tap To Place (Script)** component as follows:
-    * Uncheck the checkbox next to its name to make it inactive by default
-    * In the On **Placing Stopped ()** event section, select the + icon to add a new event:
-    * Assign the **RoverExplorer** > **RoverAssembly** object to the **None (Object)** field
-    * From the **No Function** dropdown, select **TapToPlace** > **bool Enabled** to update this property value when the event is triggered
-    * Verify that the argument checkbox is **unchecked**
+    * Uncheck the checkbox next to its name to make it inactive by default.
+    * In the On **Placing Stopped ()** event section, select the + icon to add a new event.
+    * Assign the **RoverExplorer** > **RoverAssembly** object to the **None (Object)** field.
+    * From the **No Function** dropdown, select **TapToPlace** > **bool Enabled** to update this property value when the event is triggered.
+    * Verify that the argument checkbox is **unchecked**.
 
     :::image type="content" source="../media/tap-to-place-reconfigured.png" alt-text="Screenshot of Unity with TapToPlace component reconfigured." lightbox="../media/tap-to-place-reconfigured.png":::
diff --git a/learn-pr/azure/get-started-with-object-interaction/includes/5-4-provide-description-to-objects-using-text-on-scene-tooltips.md b/learn-pr/azure/get-started-with-object-interaction/includes/5-4-provide-description-to-objects-using-text-on-scene-tooltips.md
@@ -1,3 +1,3 @@
 ## Textmesh Pro
 
-Some of the MRTK assets and prefabs require TextMesh Pro. TextMesh Pro is Unity’s text component. TextMesh Pro helps in dynamically changing the appearance by directly changing the material properties. Textmesh Pro uses custom shaders and advanced text rendering techniques to deliver visual quality improvements. TextMesh Pro must be added to your project by importing TMP Essential Resources.
+Some of the MRTK assets and prefabs require TextMesh Pro. TextMesh Pro is Unity's text component. TextMesh Pro helps in dynamically changing the appearance by directly changing the material properties. Textmesh Pro uses custom shaders and advanced text-rendering techniques to deliver visual quality improvements. You must add TextMesh Pro to your project by importing TMP Essential Resources.
diff --git a/learn-pr/azure/get-started-with-object-interaction/includes/5-6-manipulate-3d-objects-with-bounds-control.md b/learn-pr/azure/get-started-with-object-interaction/includes/5-6-manipulate-3d-objects-with-bounds-control.md
diff --git a/learn-pr/azure/get-started-with-object-interaction/includes/5-7-exercise-manipulate-3d-objects-with-bounds-control.md b/learn-pr/azure/get-started-with-object-interaction/includes/5-7-exercise-manipulate-3d-objects-with-bounds-control.md
diff --git a/learn-pr/azure/get-started-with-object-interaction/includes/5-9-summary.md b/learn-pr/azure/get-started-with-object-interaction/includes/5-9-summary.md
diff --git a/learn-pr/azure/get-started-with-object-interaction/index.yml b/learn-pr/azure/get-started-with-object-interaction/index.yml
