fixing build warnings

devices/hololens/docfx.json

@@ -17,7 +17,8 @@
       {
         "files": [
           "**/*.png",
-          "**/*.jpg"
+          "**/*.jpg",
+          "**/*.gif"
         ],
         "exclude": [
           "**/obj/**",

devices/hololens/holographic-home.md

@@ -23,7 +23,7 @@ Just like the Windows PC experience starts with an empty desktop, Windows Mixed
 
 The **Start** menu on HoloLens is where you'll open apps and get to the HoloLens camera.
 
-Wherever you are in HoloLens, you can always open the **Start** menu by using the [bloom gesture](hololens1-basic-usage.md#navigate-windows-holographic) on HoloLens (1st gen) or [tapping your wrist](hololens2-basic-usage.md#navigate-windows-holographic) on HoloLens 2. Usually, you'll use it once to get to **Start**, but sometimes you might need to use it twice.
+Wherever you are in HoloLens, you can always open the **Start** menu by using the [bloom gesture](hololens1-basic-usage.md) on HoloLens (1st gen) or [tapping your wrist](hololens2-basic-usage.md#navigate-windows-holographic) on HoloLens 2. Usually, you'll use it once to get to **Start**, but sometimes you might need to use it twice.
 
 > [!TIP]
 > When the **Start** menu is open, use the start gesture to hide it again.
@@ -50,13 +50,14 @@ You'll find your apps either pinned to **Start** or in the **All apps** list. To
 On **Start** or in the **All apps** list, select an app. It will open in a good position for viewing.
 
 > [!NOTE]
+>
 > - Up to three 2D app windows can be active at a time. You can open more, but only three will remain active.
 > - Each open app can have one active window at a time, except Microsoft Edge, which can have up to three.
->- If you're having problems with apps, make sure there's enough light in your space, and walk around so HoloLens has a current scan. If you keep having trouble, see [HoloLens and holograms: FAQ](https://support.microsoft.com/help/13456/hololens-and-holograms-faq) for more info.
+> - If you're having problems with apps, make sure there's enough light in your space, and walk around so HoloLens has a current scan. 
 
 ## Move, resize, and rotate apps
 
-Moving and resizing apps on HoloLens works a bit differently than it does on a PC. Instead of dragging the app, you'll use your gaze, along with a [gesture](https://support.microsoft.com/help/12644/hololens-use-gestures) or the [clicker](hololens-clicker.md). You can also rotate an app window in 3D space.
+Moving and resizing apps on HoloLens works a bit differently than it does on a PC. Instead of dragging the app, you'll use your gaze, along with gestures or the [clicker](hololens1-clicker.md). You can also rotate an app window in 3D space.
 
 > [!TIP]
 > Rearrange apps using your voice—gaze at an app and say "Face me," "Bigger," or "Smaller." Or have Cortana move an app for you: say "Hey Cortana, move <*app name*> here."
@@ -66,7 +67,6 @@ Moving and resizing apps on HoloLens works a bit differently than it does on a P
 Gaze at the app, and then do one of the following.
 
 - Tap and hold to select the app. Move your hand to position the app, and raise your finger to place it.
-
 - Select **Adjust**, tap and hold, and move your hand to position the app. Raise your finger to place it, then select **Done**.
 - Select **Adjust**, click and hold the clicker, and move your hand to position the app. Release the clicker, then select **Done**.
 
@@ -106,4 +106,4 @@ If you’re using HoloLens and having trouble placing holograms, here are some t
 - Make sure you’re in a well-lit room without a lot of direct sunlight.
 - Stand 1 to 3 meters from where you’re trying to place the hologram.
 - Don’t place holograms on black or reflective surfaces.
-- Walk around so HoloLens can rescan your surroundings.
+- Walk around so HoloLens can scan your surroundings.

devices/hololens/holographic-photos-and-video.md

@@ -25,13 +25,11 @@ To sync your photos and videos to OneDrive, open the OneDrive app and select **S
 
 ## Take a photo on HoloLens (1st gen)
 
-Use the [bloom gesture](hololens-use-gestures.md#the-bloom-gesture) to go to **Start**, and then select the Photos app.
+Use the open the **Start** menu, and then select the Photos app.
-
-![Animation that shows the bloom gesture](./images/hololens-bloom.gif)
 
 Use gaze to position the photo frame, then air tap to take the picture. The picture will be saved to your collection in the Photos app.</p>
 
-Want to snap a quick picture? Press the [volume up and volume down buttons](hololens-hardware.md#hololens-components) at the same time.
+Want to snap a quick picture? Press the [volume up and volume down buttons](hololens1-hardware.md#hololens-components) at the same time.
 
 ## Take a video on HoloLens (1st gen)
 

devices/hololens/hololens-calibration.md

@@ -60,7 +60,7 @@ If you followed all guidelines and calibration is still failing, you can disable
 
 ### Launching the Calibration app from Settings
 
-1. Use Start gesture to get to the [**Start** menu](holographic-mixed-reality-modern-workplace.md#navigate-the-windows-mixed-reality-home).
+1. Use Start gesture to get to the [**Start** menu](holographic-home.md).
 1. Select **All Apps** to view all apps if the Settings app isn't pinned to **Start**.
 1. Launch Settings.
 1. Navigate to **System** > **Calibration** > **Eye Calibration** and select **Run eye calibration**.
@@ -95,7 +95,7 @@ Calibration can be performed any time through the Calibration app. The Calibrati
 
 **Launching the app from Start**
 
-1. Use [bloom](hololens-use-gestures.md#the-bloom-gesture) to get to the [**Start** menu](holographic-mixed-reality-modern-workplace.md#navigate-the-windows-mixed-reality-home).
+1. Use [bloom](hololens1-basic-usage.md) to get to the **Start** menu.
 1. Select **+** to view all apps.
 1. Launch **Calibration**.
 
@@ -105,7 +105,7 @@ Calibration can be performed any time through the Calibration app. The Calibrati
 
 **Launching the app from Settings**
 
-1. Use [bloom](hololens-use-gestures.md#the-bloom-gesture) to get to the [**Start** menu](holographic-mixed-reality-modern-workplace.md#navigate-the-windows-mixed-reality-home).
+1. Use [bloom](hololens1-basic-usage.md) to get to the **Start** menu.
 1. If **Settings** isn't pinned to **Start**, select **+** to view all apps.
 1. Launch **Settings**.
 1. Navigate to **System** > **Utilities** and select **Open Calibration**.

devices/hololens/hololens-feedback.md

@@ -0,0 +1,86 @@
+---
+title: Give us feedback
+description: Create actionable feedback for HoloLens and Windows Mixed Reality developers using the Feedback Hub.
+ms.assetid: b9b24c72-ff86-44a9-b30d-dd76c49479a9
+author: mattzmsft
+ms.author: mazeller
+ms.date: 08/30/2019
+ms.prod: hololens
+ms.topic: article
+keywords: feedback, bug, issue, error, troubleshoot, help
+manager: jarrettr
+appliesto:
+- HoloLens 1
+- HoloLens 2
+---
+
+# Give us feedback
+
+Use the Feedback Hub to tell us which features you love, which features you could do without, or when something could be better.
+
+## Feedback for Windows Mixed Reality immersive headset on PC
+
+- Ensure you have the immersive headset connected to your PC.
+- Launch **Feedback Hub** on desktop with the HMD connected.
+- Go to **Feedback Tab** on the left pane.  
+
+  ![Feedback Tab](images/feedback1-600px.png)
+- Select **Add new feedback** button to enter a new feedback.
+
+  ![Add new feedback](images/feedback2-600px.png)
+- Select **Problem** in **What kind of feedback is this?** to make feedback actionable.
+- Provide meaningful feedback title in **Summarize your issue** box.
+- Provide details and repro steps in the **Give us more detail** box.
+
+  ![Details and repro steps](images/feedback3-600px.png)
+- Select **Mixed Reality** top category and then pick an applicable sub category:
+
+  |Subcategory  |Description |
+  |----------|----------|
+  |  Apps  |  Issues with a specific application. |
+  |  Developer  |  Issues in authoring / running an app for Mixed Reality. |
+  |  Device  |  Issues with the HMD itself. |
+  |  Home experience  |  Issues with your VR environment: interactions with the your mixed reality home. |
+  |  Input  |  Issues with input methods: motion controllers, speech, gamepad, or mouse and keyboard. |
+  |  Set up  |  Anything that is preventing you from setting up the device. |
+  |  All other issues  |  Anything else. |
+  
+- To help us identify and fix the bug faster, capturing traces and video is extremely helpful. To start collecting traces, click on **Start capture**. This will begin collecting traces and a video capture of your mixed reality scenario.
+
+  ![Start Capture](images/feedback4-600px.png)
+- Leave the Feedback app and run through the broken scenario. Do not close the Feedback Hub app at this point.
+- After you are done with your scenario, go back to the feedback app and select **Stop Capture**. Once you do that, you should see that a file containing the traces has been added.
+- Select **Submit**.
+
+  ![Submit](images/feedback5-600px.png)
+- This will lead you to Thank You page.
+
+  ![Thank You](images/feedback6-600px.png)
+- At this point, your feedback has been successfully submitted.
+- After you submit feedback, to easily direct other people (such as co-workers, Microsoft staff, [forum](https://forums.hololens.com/) readers et al) to the issue go to **Feedback** > **My Feedback**, click on the issue, and use the **Share** icon to get a shortened URL you can give to others to upvote, or escalate.
+
+> [!NOTE]
+> Before filing a bug, please ensure you meet the following constraints so that the logs are successfully uploaded with the feedback:
+>
+> - Have a minimum of 3GB free disk space available on the main drive of the device.
+> - Ensure that a non-metered network is available in order to upload cabs.
+
+## Feedback for HoloLens
+
+1. Use the **bloom** gesture to bring up the **Start** menu.
+1. Select **Feedback Hub** from **Start**.
+
+   ![Start menu on Microsoft HoloLens](images/startmenu.jpg)
+1. Place the app in your environment and then select the app to launch it.
+1. See if someone else has given similar feedback by entering the topic, such as "Keyboard".
+
+   ![Search Feedback](images/searchfeedback-500px.jpg)
+1. If you find similar feedback, select it, add any details, then select **Upvote**.
+
+   ![Upvote existing Feedback](images/upvotefeedback-500px.jpg)
+1. If you don’t find any similar feedback, select **Add new feedback**, and choose a topic from **Select a category** and then **Select a subcategory**.
+
+   ![Add new Feedback](images/addnewfeedback-500px.jpg)
+1. Enter your feedback.
+1. If you have a repro, you can click **Reproduce** and repro your feedback. When you are done, come back to Feedback Hub and click **I’m done**. This will collect Mixed Reality Capture of your repro and relevant diagnostic logs will be collected.
+1. You’re done.

devices/hololens/hololens-spaces.md

@@ -117,5 +117,4 @@ HoloLens will visually compare the current scanning data from the sensors to loc
 
 ## Related topics
 
-- [Environment considerations for HoloLens](hololens-environment-considerations)
 - [Spatial mapping design](https://docs.microsoft.com/windows/mixed-reality/spatial-mapping-design)

devices/hololens/hololens1-basic-usage.md

@@ -27,20 +27,39 @@ On HoloLens, holograms blend with your physical environment to look and sound li
 
 The holographic frame positions your holograms where your eyes are most sensitive to detail, and the see-through lenses leave your peripheral vision unobscured. With spatial sound, you can pinpoint a hologram even if it’s behind you. And because HoloLens learns and understands your environment, you can place holograms on and around real objects—and so can your apps and games. So a character in a game might sit down on your sofa, or [space robots could bust out of your walls](https://www.microsoft.com/store/apps/9nblggh5fv3j).
 
-## Using gaze, gesture, voice
+## Use HoloLens with your hands
 
-Instead of pointing, clicking, or tapping, you'll use your gaze, your [voice](hololens-cortana.md), and gestures to select apps and holograms and to get around HoloLens.
+Getting around HoloLens is a lot like using your smart phone. You can use your hands to manipulate holographic windows, menus, and buttons.  Instead of pointing, clicking, or tapping, you'll use your gaze, your [voice](hololens-cortana.md), and gestures to select apps and holograms and to get around HoloLens.
+
+Once you know these basic interactions, getting around on HoloLens will be a snap.
 
 We'll walk you through the basics the first time you use your HoloLens. You'll also find a gesture tutorial on your Start menu—look for the Learn Gestures app.
 
+### The hand-tracking frame
+
+HoloLens has sensors that can see a few feet to either side of you. When you use your hands, you'll need to keep them inside that frame, or HoloLens won't see them. As you move around, the frame moves with you.  
+
+![Image that shows the HoloLens hand-tracking frame](./images/hololens-2-gesture-frame.png)
+
 ### Open the Start menu with bloom
 
+To open the start menu:
+
+1. Hold your hand in front of you so it's in the gesture frame.
+1. Bloom: bring all of your fingers together then open your hand.
+
+![Animation that shows the bloom gesture](./images/hololens-bloom.gif)
+
 ### Select holograms with gaze and air tap
 
+To select an app or other hologram, air tap it while looking directly at the hologram you're selecting. To do this, follow these steps:
+
 1. Gaze at the hologram you want to select.
 1. Point your index finger straight up toward the ceiling.
 1. Air tap: lower your finger, then quickly raise it.
 
+    ![Air-tap gesture animation](./images/hololens-air-tap.gif)
+
 ### Select a hologram by using your voice
 
 1. To bring up the gaze cursor, say “Select.” The gaze cursor is a dot that you move around by moving your head. You can use it to target voice commands with precision.
@@ -81,27 +100,15 @@ If you’re using HoloLens and having trouble placing holograms, here are some t
 
 ## Meet the HoloLens (1st gen) Clicker
 
-The [HoloLens (1st Gen) clicker](hololens-clicker.md) gives you another way to interact with holograms. [Pair it](hololens-connect-devices.md) with your HoloLens and then use it along with your gaze to select, scroll, and more.
+The [HoloLens (1st Gen) clicker](hololens1-clicker.md) gives you another way to interact with holograms. [Pair it](hololens-connect-devices.md) with your HoloLens and then use it along with your gaze to select, scroll, and more.
 Learn to navigate around HoloLens (1st gen).
 
-## Using gaze, gesture, voice
-
-Instead of pointing, clicking, or tapping, you'll use your gaze, your [voice](hololens-cortana.md), and  to select apps and holograms and to get around HoloLens. We'll walk you through the basics the first time you use your HoloLens. You'll also find a gesture tutorial on your Start menu—look for the Learn Gestures app.
-
-### Select holograms using gaze and gestures
-
-1. Gaze at the hologram you want to select.
-1. Point your index finger straight up toward the ceiling.
-1. Air tap: lower your finger, then quickly raise it.
-
-[Getting around HoloLens](https://support.microsoft.com/en-us/hub/4338666/hololens-help)
-
-[Use gestures](https://support.microsoft.com/en-us/help/12644)
-
-[Calibration](https://docs.microsoft.com/en-us/windows/mixed-reality/calibration)
-
 ## Next Steps
 
-### Connect bluetooth devices
+Congratulations! you're ready to use HoloLens (1st gen).
 
-### Explore holographic apps and services
+Now you can configure your HoloLens (1st gen) to meet your specific needs.
+
+[Connect bluetooth devices](hololens-connect-devices.md)
+
+[Learn more about Voice and Cortana](hololens-cortana.md)

devices/hololens/hololens2-basic-usage.md

@@ -178,7 +178,7 @@ You can also move your hands closer and further away from your body to rotate th
 
 ### Follow me, stay there
 
-
+Generally, holograms and apps stay where you placed them.  That's not always convenient if you need to move around and want an application to stay visible.  Select "follow me" in the top right corner of applications (next to the close button) to ask apps to follow or unfollow.
 
 ## Help! I can’t see or place holograms
 
@@ -197,6 +197,4 @@ Now you can configure your HoloLens 2 to meet your specific needs.
 
 [Connect bluetooth devices](hololens-connect-devices.md)
 
-[Discover holographic apps and services](holographic-mixed-reality-modern-workplace.md)
-
 [Learn more about Voice and Cortana](hololens-cortana.md)