Merge branch 'public' into patch-59

2025-06-15 10:23:37 +00:00 · 2020-03-19 16:38:08 -07:00
parent b55dd466d5 a5c1450261
commit 9990e27bed
171 changed files with 3603 additions and 3589 deletions
--- a/devices/hololens/TOC.md
+++ b/devices/hololens/TOC.md
@ -1,6 +1,6 @@
-# [HoloLens overview](index.md)
+# [Microsoft HoloLens](index.md)

-# Get Started with HoloLens 2
+# Get started with HoloLens 2
 ## [HoloLens 2 hardware](hololens2-hardware.md)
 ## [Get your HoloLens 2 ready to use](hololens2-setup.md)
 ## [Set up your HoloLens 2](hololens2-start.md)
@ -16,56 +16,56 @@
 ## [Install localized version of HoloLens (1st gen)](hololens1-install-localized.md)
 ## [Getting around HoloLens (1st gen)](hololens1-basic-usage.md)

-# Deploying HoloLens and Mixed Reality Apps in Commercial Environments
-## [Deployment planning](hololens-requirements.md)
-## [Commercial feature overview](hololens-commercial-features.md)
-## [Lincense Requriements](hololens-licenses-requirements.md)
-## [Commercial Infrastructure Guidance](hololens-commercial-infrastructure.md)
+# Deploy HoloLens and mixed-reality apps in commercial environments
+## [Commercial features](hololens-commercial-features.md)
+## [Deploy HoloLens in a commercial environment](hololens-requirements.md)
+## [Determine what licenses you need](hololens-licenses-requirements.md)
+## [Configure your network for HoloLens](hololens-commercial-infrastructure.md)
 ## [Unlock Windows Holographic for Business features](hololens1-upgrade-enterprise.md)
-## [Configure HoloLens using a provisioning package](hololens-provisioning.md)
+## [Use a provisioning package to configure HoloLens](hololens-provisioning.md)
 ## [Enroll HoloLens in MDM](hololens-enroll-mdm.md)
-## [Set up ring based updates for HoloLens](hololens-updates.md)
+## [Manage HoloLens updates](hololens-updates.md)
 ## [Enable Bitlocker device encryption for HoloLens](hololens-encryption.md)

 # Navigating Windows Holographic
 ## [Start menu and mixed reality home](holographic-home.md)
 ## [Use your voice with HoloLens](hololens-cortana.md)
-## [Find and save files](holographic-data.md)
-## [Create, share, and view photos and video](holographic-photos-and-videos.md)
+## [Find, open, and save files](holographic-data.md)
+## [Create mixed reality photos and videos](holographic-photos-and-videos.md)

 # User management and access management
-## [Accounts on HoloLens](hololens-identity.md)
+## [Manage user identity and sign-in for HoloLens](hololens-identity.md)
 ## [Share your HoloLens with multiple people](hololens-multiple-users.md)
-## [Set up HoloLens as a kiosk (single application access)](hololens-kiosk.md)
-## [Set up limited application access](hololens-kiosk.md)
+## [Set up HoloLens as a kiosk for specific applications](hololens-kiosk.md)

-# Holographic Applications
-## [Try 3D Viewer](holographic-3d-viewer-beta.md)
+# Holographic applications
+## [Use 3D Viewer on HoloLens](holographic-3d-viewer-beta.md)
 ## [Find, install, and uninstall applications](holographic-store-apps.md)
-## [Install and uninstall custom applications](holographic-custom-apps.md)
+## [Manage custom apps for HoloLens](holographic-custom-apps.md)

 # Accessories and connectivity
 ## [Connect to Bluetooth and USB-C devices](hololens-connect-devices.md)
 ## [Use the HoloLens (1st gen) clicker](hololens1-clicker.md)
 ## [Connect to a network](hololens-network.md)
-## [Use HoloLens offline](hololens-offline.md)
+## [Manage connection endpoints for HoloLens](hololens-offline.md)

 # Hologram optics and placement in space
-## [Tips for viewing clear Holograms](hololens-calibration.md)
+## [Improve visual quality and comfort](hololens-calibration.md)
 ## [Environment considerations for HoloLens](hololens-environment-considerations.md)
-## [Spatial mapping on HoloLens](hololens-spaces.md)
+## [Map physical spaces with HoloLens](hololens-spaces.md)

 # Update, troubleshoot, or recover HoloLens
 ## [Update HoloLens](hololens-update-hololens.md)
-## [Restart, reset, or recover](hololens-recovery.md)
-## [Troubleshoot HoloLens](hololens-troubleshooting.md)
-## [Known issues](hololens-known-issues.md)
+## [Restart, reset, or recover HoloLens](hololens-recovery.md)
+## [Troubleshoot HoloLens issues](hololens-troubleshooting.md)
+## [Known issues for HoloLens](hololens-known-issues.md)
 ## [Frequently asked questions](hololens-faq.md)
 ## [Frequently asked security questions](hololens-faq-security.md)
-## [Hololens services status](hololens-status.md)
-## [SCEP Whitepaper](scep-whitepaper.md)
+## [Status of the HoloLens services](hololens-status.md)
+## [Get support](https://support.microsoft.com/supportforbusiness/productselection?sapid=3ec35c62-022f-466b-3a1e-dbbb7b9a55fb)
+## [SCEP whitepaper](scep-whitepaper.md)

-# [Release Notes](hololens-release-notes.md)
+# [HoloLens release notes](hololens-release-notes.md)
 # [Give us feedback](hololens-feedback.md)
-# [Join the Windows Insider program](hololens-insider.md)
+# [Insider preview for Microsoft HoloLens](hololens-insider.md)
 # [Change history for Microsoft HoloLens documentation](change-history-hololens.md)
--- a/devices/hololens/holographic-custom-apps.md
+++ b/devices/hololens/holographic-custom-apps.md
@ -1,6 +1,6 @@
 ---
 title: Manage custom apps for HoloLens
-description: Side load custom apps on HoloLens.  Learn more about installing, and uninstalling holographic apps.
+description: Side load custom apps on HoloLens. Learn more about installing, and uninstalling holographic apps.
 ms.assetid: 6bd124c4-731c-4bcc-86c7-23f9b67ff616
 ms.date: 07/01/2019
 manager: v-miegge
@ -11,12 +11,15 @@ author: mattzmsft
 ms.author: mazeller
 ms.topic: article
 ms.localizationpriority: medium
+ms.custom: 
+- CI 111456
+- CSSTroubleshooting
 appliesto:
 - HoloLens (1st gen)
 - HoloLens 2
 ---

-# Install and manage custom applications (non-store)
+# Manage custom apps for HoloLens

 HoloLens supports many existing applications from the Microsoft Store, as well as new apps built specifically for HoloLens. This article focuses on custom holographic applications.  

--- a/devices/hololens/hololens-FAQ.md
+++ b/devices/hololens/hololens-FAQ.md
@ -207,7 +207,7 @@ You can pair other Bluetooth HID and GATT devices together with your HoloLens. H

 Use the [clicker](hololens1-clicker.md) to select, scroll, move, and resize holograms. Individial apps may support additional clicker gestures.

-If you're having trouble using the clicker, make sure that it's charged and paired with your HoloLens. If the battery is low, the indicator light blinks amber. To verify that the clicker is paired, go to **Settings** > **Devices** and see if it shows up there. For more information, see [Pair the clicker](hololens-connect-devices.md#pair-the-clicker).
+If you're having trouble using the clicker, make sure that it's charged and paired with your HoloLens. If the battery is low, the indicator light blinks amber. To verify that the clicker is paired, go to **Settings** > **Devices** and see if it shows up there. For more information, see [Pair the clicker](hololens-connect-devices.md#hololens-1st-gen-pair-the-clicker).

 If the clicker is charged and paired and you're still having problems, reset it by holding down the main button and the pairing button for 15 seconds. Then pair the clicker with your HoloLens again.

--- a/devices/hololens/hololens-calibration.md
+++ b/devices/hololens/hololens-calibration.md
@ -33,7 +33,8 @@ HoloLens 2 prompts a user to calibrate the device under the following circumstan
 - The user previously opted out of the calibration process
 - The calibration process did not succeed the last time the user used the device
 - The user has deleted their calibration profiles
- The visor is raised and the lowered and any of the above circumstances apply (this may be disabled in **Settings > System > Calibration**.)
+- The device is taken off and put back on and any of the above circumstances apply 
+

 ![Calibration prompt](./images/07-et-adjust-for-your-eyes.png)

--- a/devices/hololens/hololens-commercial-features.md
+++ b/devices/hololens/hololens-commercial-features.md
@ -5,6 +5,9 @@ keywords: HoloLens, commercial, features, mdm, mobile device management, kiosk m
 author: scooley
 ms.author: scooley
 ms.date: 08/26/2019
+ms.custom: 
+- CI 111456
+- CSSTroubleshooting
 ms.topic: article
 audience: ITPro
 ms.prod: hololens
@ -40,7 +43,7 @@ HoloLens (1st gen) came with two licensing options, the developer license and a
 - **Windows Update for Business.** Windows Update for Business provides controlled operating system updates to devices and support for the long-term servicing channel.
 - **Data security.** BitLocker data encryption is enabled on HoloLens to provide the same level of security protection as any other Windows device.
 - **Work access.** Anyone in your organization can remotely connect to the corporate network through virtual private network (VPN) on a HoloLens. HoloLens can also access Wi-Fi networks that require credentials.
- **Microsoft Store for Business.** Your IT department can also set up an enterprise private store, containing only your company’s apps for your specific HoloLens usage. Securely distribute your enterprise software to selected group of enterprise users.
+- **Microsoft Store for Business.** Your IT department can also set up an enterprise private store, containing only your company's apps for your specific HoloLens usage. Securely distribute your enterprise software to selected group of enterprise users.

 ## Feature comparison between editions

@ -48,7 +51,7 @@ HoloLens (1st gen) came with two licensing options, the developer license and a
 |---|:---:|:---:|:---:|
 |Device Encryption (BitLocker) | |✔️ |✔️ |
 |Virtual Private Network (VPN) | |✔️ |✔️ |
-|[Kiosk mode](https://docs.microsoft.com/windows/mixed-reality/using-the-windows-device-portal#kiosk-mode) | |✔️ |✔️ |
+|[Kiosk mode](hololens-kiosk.md) | |✔️ |✔️ |
 |**Management and deployment** | | | |
 |Mobile Device Management (MDM) | |✔️ |✔️ |
 |Ability to block unenrollment | |✔️ |✔️ |
@ -67,12 +70,12 @@ HoloLens (1st gen) came with two licensing options, the developer license and a

 ## Enabling commercial features

-Your organization's IT admin can set up commercial features such as Microsoft Store for Business, kiosk mode, and enterprise Wi-Fi access. The [Microsoft HoloLens](https://docs.microsoft.com/hololens) documentation provides step-by-step instructions for enrolling devices and installing apps from Microsoft Store for Business.
+Your organization's IT admin can set up commercial features such as Microsoft Store for Business, kiosk mode, and enterprise Wi-Fi access. The [Microsoft HoloLens](index.md) documentation provides step-by-step instructions for enrolling devices and installing apps from Microsoft Store for Business.

 ## See also

- [Microsoft HoloLens](https://docs.microsoft.com/hololens)
- [Kiosk mode](/windows/mixed-reality/using-the-windows-device-portal.md#kiosk-mode)
+- [Microsoft HoloLens](index.md)
+- [Kiosk mode](hololens-kiosk.md)
 - [CSPs supported in HoloLens devices](/windows/client-management/mdm/configuration-service-provider-reference#csps-supported-in-hololens-devices)
 - [Microsoft Store For Business and line of business applications](https://blogs.technet.microsoft.com/sbucci/2016/04/13/windows-store-for-business-and-line-of-business-applications/)
 - [Working with line-of-business apps](/microsoft-store/working-with-line-of-business-apps)
--- a/devices/hololens/hololens-connect-devices.md
+++ b/devices/hololens/hololens-connect-devices.md
@ -8,7 +8,7 @@ author: Teresa-Motiv
 ms.author: v-tea
 ms.topic: article
 ms.localizationpriority: high
-ms.date: 09/13/2019
+ms.date: 03/11/2020
 manager: jarrettr
 appliesto:
 - HoloLens (1st gen)
@ -19,56 +19,58 @@ appliesto:

 ## Pair Bluetooth devices

-Pair a Bluetooth mouse and keyboard with HoloLens, then use them to interact with holograms and to type anywhere you'd use the holographic keyboard.
-
-Classes of Bluetooth devices supported by HoloLens 2:
+HoloLens 2 supports the following classes of Bluetooth devices:

 - Mouse
 - Keyboard
 - Bluetooth audio output (A2DP) devices

-Classes of Bluetooth devices supported by HoloLens (1st gen):
+HoloLens (1st gen) supports the following classes of Bluetooth devices:

 - Mouse
 - Keyboard
 - HoloLens (1st gen) clicker

 > [!NOTE]
-> Other types of Bluetooth devices, such as speakers, headsets, smartphones, and game pads, may appear as available in HoloLens settings, but aren't supported on HoloLens (1st gen). [Learn more](https://go.microsoft.com/fwlink/p/?LinkId=746660).
+> Other types of Bluetooth devices, such as speakers, headsets, smartphones, and game pads, may be listed as available in HoloLens settings. However, these devices aren't supported on HoloLens (1st gen). For more information, see [I'm having problems pairing or using a Bluetooth device](hololens-FAQ.md#im-having-problems-pairing-or-using-a-bluetooth-device).

 ### Pair a Bluetooth keyboard or mouse

-1. Turn on your keyboard or mouse and make it discoverable. The way you make it discoverable depends on the device. To learn how to do this, check the device or visit the manufacturer's website.
+1. Turn on your keyboard or mouse, and make it discoverable. To learn how to make the device discoverable, look for information on the device (or its documentation) or visit the manufacturer's website.

-1. Use the bloom gesture (HoloLens (1st gen) or the start gesture (HoloLens 2) to go to **Start**, then select **Settings**.
-1. Select **Devices** and make sure that Bluetooth is on. When you see the device name, select **Pair** and follow the instructions.
+1. Use the bloom gesture (HoloLens (1st gen)) or the start gesture (HoloLens 2) to go to **Start**, and then select **Settings**.
+1. Select **Devices**, and make sure that Bluetooth is on.  
+1. When you see the device name, select **Pair**, and then follow the instructions.

-### Pair the clicker
+### HoloLens (1st gen): Pair the clicker

-> Applies to HoloLens (1st gen) only.
-
-1. Use the bloom gesture to go to **Start**, then select **Settings**.
-
-1. Select **Devices** and make sure that Bluetooth is on.
-1. Use the tip of a pen to press and hold the clicker's pairing button until the status light blinks white. Make sure to hold the button down until the light starts blinking. [Where's the pairing button?](hololens1-clicker.md)
+1. Use the bloom gesture to go to **Start**, and then select **Settings**.
+1. Select **Devices**, and make sure that Bluetooth is on.
+1. Use the tip of a pen to press and hold the clicker pairing button until the clicker status light blinks white. Make sure to hold down the button until the light starts blinking.  
+   The pairing button is on the underside of the clicker, next to the finger loop.
+   ![The pairing button is beside the finger loop](images/use-hololens-clicker-1.png)
 1. On the pairing screen, select **Clicker** > **Pair**.

-## Connect USB-C devices
+## HoloLens 2: Connect USB-C devices

-> Applies to HoloLens 2 only.
-
-HoloLens 2 lets you connect a wide range of USB-C devices.
-
-HoloLens 2 supports the following devices classes:
+HoloLens 2 supports the following classes of USB-C devices:

 - Mass storage devices (such as thumb drives)
- Ethernet adapters (including ethernet with charging)
- USB-C to 3.5mm digital audio adapters
- USB-C digital audio headsets (including headset adapters with charging)
+- Ethernet adapters (including ethernet plus charging)
+- USB-C-to-3.5mm digital audio adapters
+- USB-C digital audio headsets (including headset adapters plus charging)
 - Wired mouse
 - Wired keyboard
- Combination PD hubs (USB A + PD charging)
+- Combination PD hubs (USB A plus PD charging)

 ## Connect to Miracast

-Use Miracast by opening the **Start** menu and selecting the display icon or saying "Connect" while gazing at the **Start** menu. Choose an available device from the list that appears and complete pairing to begin projection.
+To use Miracast, follow these steps:
+
+1. Do one of the following:  
+
+   - Open the **Start** menu, and select the display icon.
+   - Say "Connect" while you gaze at the **Start** menu.  
+
+1. On the list of devices that appears, select an available device.
+1. Complete the pairing to begin projecting.
--- a/devices/hololens/hololens-cortana.md
+++ b/devices/hololens/hololens-cortana.md
@ -2,13 +2,13 @@
 title: Use your voice with HoloLens
 description: Cortana can help you do all kinds of things on your HoloLens
 ms.assetid: fd96fb0e-6759-4dbe-be1f-58bedad66fed
-ms.date: 11/8/2019
+ms.date: 03/10/2020
 keywords: hololens
 ms.prod: hololens
 ms.sitesec: library
-author: v-miegge
+author: Teresa-Motiv
 audience: ITPro
-ms.author: v-miegge
+ms.author: v-tea
 ms.topic: article
 manager: jarrettr
 ms.localizationpriority: high
@ -63,11 +63,11 @@ To use these commands, gaze at a 3D object, hologram, or app window.

 ### See it, say it

-Many buttons and other elements on HoloLens also respond to your voice—for example, **Follow me** and **Close** on the app bar, or the **Back** button in Edge. To find out if a button is voice-enabled, rest your **gaze cursor** on it for a moment to see a voice tip.
+Many buttons and other elements on HoloLens also respond to your voice—for example, **Follow me** and **Close** on the app bar, or the **Back** button in Edge. To find out if a button is voice-enabled, rest your **gaze cursor**,**touch cursor** or one **hand ray** on it for a moment. If the button is voice-enabled, you'll see a voice tip.

 ### Dictation mode

-Tired of typing? Switch to dictation mode any time that the holographic keyboard is active. To get started, select the microphone button or say "Start dictating." To stop dictating, select the button again or say "Stop dictating." To delete what you just dictated, say "Delete that."
+Tired of typing? Switch to dictation mode any time that the holographic keyboard is active. To get started, select the microphone button or say "Start dictating." To stop dictating, select the button again or say "Stop dictating." To delete what you just dictated, say "Delete that." 

 > [!NOTE]
 > To use dictation mode, you have to have an internet connection.
--- a/devices/hololens/hololens-faq-security.md
+++ b/devices/hololens/hololens-faq-security.md
@ -11,15 +11,18 @@ ms.sitesec: library
 ms.topic: article
 audience: ITPro
 ms.localizationpriority: high
+ms.custom: 
+- CI 111456
+- CSSTroubleshooting
 manager: bradke
 appliesto:
 - HoloLens 1 (1st gen)
 - HoloLens 2
 ---

-# Frequently Asked Security Questions
+# Frequently asked questions about HoloLens security

-## HoloLens 1st Gen Security Questions
+## HoloLens (1st gen) Security Questions

 1. **What type of wireless is used?**
    1. 802.11ac and Bluetooth 4.1 LE
@ -67,9 +70,9 @@ appliesto:
    1. This is something that can be managed on the infrastructure level by either an MDM or an on-prem server. The device can be flagged as not compliant if it does not meet a specified Update version.
 1. **Does Microsoft include any back doors or access to services that allows Microsoft to connect to the device for screen sharing or remote support at will?**
    1. No
-1. **When a PKI cert is being generated for trusted communication, we want the cert to be generated on the device so that we know it’s only on that device, unique to that device, and can’t be exported or used to impersonate the device. Is this true on HoloLens? If not is there a potential mitigation?**
-    1. CSR for SCEP is generated on the device itself. Intune and the on premise SCEP connector help secure the requests themselves by adding and verifying a challenge string that’s sent to the client.
-    1. Since HoloLens (1st Gen and 2nd Gen) have a TPM module, these certs would be stored in the TPM module, and are unable to be extracted. Additionally, even if it could be extracted, the challenge strings couldn’t be verified on a different device, rendering the certs/key unusable on different devices.
+1. **When a PKI cert is being generated for trusted communication, we want the cert to be generated on the device so that we know it's only on that device, unique to that device, and can't be exported or used to impersonate the device. Is this true on HoloLens? If not is there a potential mitigation?**
+    1. CSR for SCEP is generated on the device itself. Intune and the on premise SCEP connector help secure the requests themselves by adding and verifying a challenge string that's sent to the client.
+    1. Since HoloLens (1st Gen and 2nd Gen) have a TPM module, these certs would be stored in the TPM module, and are unable to be extracted. Additionally, even if it could be extracted, the challenge strings couldn't be verified on a different device, rendering the certs/key unusable on different devices.
 1. **SCEP is vulnerable. How does Microsoft mitigate the known vulnerabilities of SCEP?**
    1. This [SCEP Whitepaper](scep-whitepaper.md) addresses how Microsoft mitigates SCEP vulnerabilities.

@ -87,7 +90,7 @@ appliesto:
 1. **Can the device blacklist or white list specific frequencies?**
    1. This is not controllable by the user/device
 1. **What is the power level for both transmit and receive? Is it adjustable? What is the range of operation?**
-    1. Wireless power levels depend on the channel of operation. Devices are calibrated to perform at the highest power levels allowed based on the region’s regulatory rules.
+    1. Wireless power levels depend on the channel of operation. Devices are calibrated to perform at the highest power levels allowed based on the region's regulatory rules.
 1. **What is the duty cycle/lifetime for normal operation?**
    1. *Currently unavailable.*
 1. **What is transmit and receive behavior when a tool is not in range?**
@ -119,8 +122,8 @@ appliesto:
    1. This is something that can be managed on the infrastructure level by either an MDM or an on-prem server. The device can be flagged as not compliant if it does not meet a specified Update version.
 1. **Does Microsoft include any back doors or access to services that allows Microsoft to connect to the device for screen sharing or remote support at will?**
    1. No
-1. **When a PKI cert is being generated for trusted communication, we want the cert to be generated on the device so that we know it’s only on that device, unique to that device, and can’t be exported or used to impersonate the device. Is this true on HoloLens? If not is there a potential mitigation?**
-    1. CSR for SCEP is generated on the device itself. Intune and the on premise SCEP connector help secure the requests themselves by adding and verifying a challenge string that’s sent to the client.
-    1. Since HoloLens (1st Gen and 2nd Gen) have a TPM module, these certs would be stored in the TPM module, and are unable to be extracted. Additionally, even if it could be extracted, the challenge strings couldn’t be verified on a different device, rendering the certs/key unusable on different devices.
+1. **When a PKI cert is being generated for trusted communication, we want the cert to be generated on the device so that we know it's only on that device, unique to that device, and can't be exported or used to impersonate the device. Is this true on HoloLens? If not is there a potential mitigation?**
+    1. CSR for SCEP is generated on the device itself. Intune and the on premise SCEP connector help secure the requests themselves by adding and verifying a challenge string that's sent to the client.
+    1. Since HoloLens (1st Gen and 2nd Gen) have a TPM module, these certs would be stored in the TPM module, and are unable to be extracted. Additionally, even if it could be extracted, the challenge strings couldn't be verified on a different device, rendering the certs/key unusable on different devices.
 1. **SCEP is vulnerable. How does Microsoft mitigate the known vulnerabilities of SCEP?**
    1. This [SCEP Whitepaper](scep-whitepaper.md) addresses how Microsoft mitigates SCEP vulnerabilities.
--- a/devices/hololens/hololens-identity.md
+++ b/devices/hololens/hololens-identity.md
@ -1,12 +1,15 @@
 ---
-title: Managing user identity and login on HoloLens
-description: Manage user identity, security, and login on HoloLens.
+title: Manage user identity and sign-in for HoloLens
+description: Manage user identity, security, and sign-in for HoloLens.
 keywords: HoloLens, user, account, aad, adfs, microsoft account, msa, credentials, reference
 ms.assetid: 728cfff2-81ce-4eb8-9aaa-0a3c3304660e
 author: scooley
 ms.author: scooley
-ms.date: 1/6/2019
+ms.date: 1/6/2020
 ms.prod: hololens
+ms.custom: 
+- CI 111456
+- CSSTroubleshooting
 ms.topic: article
 ms.sitesec: library
 ms.topic: article
@ -18,7 +21,7 @@ appliesto:
 - HoloLens 2
 ---

-# User identity and signin
+# Manage user identity and sign-in for HoloLens

 > [!NOTE]
 > This article is a technical reference for IT Pros and tech enthusiasts. If you're looking for HoloLens set up instructions, read "[Setting up your HoloLens (1st gen)](hololens1-start.md)" or "[Setting up your HoloLens 2](hololens2-start.md)".
--- a/devices/hololens/hololens-insider.md
+++ b/devices/hololens/hololens-insider.md
@ -1,11 +1,14 @@
 ---
-title: Insider preview for Microsoft HoloLens (HoloLens)
-description: It’s simple to get started with Insider builds and to provide valuable feedback for our next major operating system update for HoloLens.
+title: Insider preview for Microsoft HoloLens
+description: It's simple to get started with Insider builds and to provide valuable feedback for our next major operating system update for HoloLens.
 ms.prod: hololens
 ms.sitesec: library
 author: scooley
 ms.author: scooley
 ms.topic: article
+ms.custom: 
+- CI 111456
+- CSSTroubleshooting
 ms.localizationpriority: medium
 audience: ITPro
 ms.date: 1/6/2020
@ -17,13 +20,13 @@ appliesto:

 # Insider preview for Microsoft HoloLens

-Welcome to the latest Insider Preview builds for HoloLens!  It’s simple to get started and provide valuable feedback for our next major operating system update for HoloLens.
+Welcome to the latest Insider Preview builds for HoloLens!  It's simple to get started and provide valuable feedback for our next major operating system update for HoloLens.

 ## Start receiving Insider builds

 On a HoloLens 2 device go to **Settings** -> **Update & Security** -> **Windows Insider Program** and select **Get started**. Link the account you used to register as a Windows Insider.

-Then, select **Active development of Windows**, choose whether you’d like to receive **Fast** or **Slow** builds, and review the program terms.
+Then, select **Active development of Windows**, choose whether you'd like to receive **Fast** or **Slow** builds, and review the program terms.

 Select **Confirm -> Restart Now** to finish up. After your device has rebooted, go to **Settings -> Update & Security -> Check for updates** to get the latest build.

@ -46,7 +49,7 @@ To opt out of Insider builds:
 Please use [the Feedback Hub app](hololens-feedback.md) on your HoloLens to provide feedback and report issues. Using Feedback Hub ensures that all necessary diagnostics information is included to help our engineers quickly debug and resolve the problem.  Issues with the Chinese and Japanese version of HoloLens should be reported the same way.

 > [!NOTE]
-> Be sure to accept the prompt that asks whether you’d like Feedback Hub to access your Documents folder (select **Yes** when prompted).
+> Be sure to accept the prompt that asks whether you'd like Feedback Hub to access your Documents folder (select **Yes** when prompted).

 ## Note for developers

@ -68,7 +71,7 @@ Here's a quick summary of what's new:
 - Performance and stability improvements across the product
 - More information in settings on HoloLens about the policy pushed to the device

-Once you’ve had a chance to explore these new capabilities, use the Feedback Hub app to let us know what you think. Feedback you provide in the Feedback Hub goes directly to our engineers.
+Once you've had a chance to explore these new capabilities, use the Feedback Hub app to let us know what you think. Feedback you provide in the Feedback Hub goes directly to our engineers.

 ### FIDO 2 support
 Many of you share a HoloLens with lots of people in a work or school environment.  Whether devices are shared between students in a classroom or they're checked out from a device locker, it's important to be able to change users quickly and easily without typing long user names and passwords.  FIDO lets anyone in your organization (AAD tenant) seamlessly sign in to HoloLens without entering a username or password.
--- a/devices/hololens/hololens-kiosk.md
+++ b/devices/hololens/hololens-kiosk.md
@ -1,5 +1,5 @@
 ---
-title: Set up HoloLens in kiosk mode (HoloLens)
+title: Set up HoloLens as a kiosk for specific applications
 description: Use a kiosk configuration to lock down the apps on HoloLens. 
 ms.prod: hololens
 ms.sitesec: library
@ -8,15 +8,21 @@ ms.author: dansimp
 ms.topic: article
 ms.localizationpriority: medium
 ms.date: 11/13/2018
+ms.custom: 
+- CI 111456
+- CSSTroubleshooting
 ms.reviewer: 
 manager: dansimp
+appliesto:
+- HoloLens (1st gen)
+- HoloLens 2
 ---

-# Set up HoloLens in kiosk mode
+# Set up HoloLens as a kiosk for specific applications

 In Windows 10, version 1803, you can configure your HoloLens devices to run as multi-app or single-app kiosks. You can also configure guest access for a HoloLens kiosk device by [designating a SpecialGroup account in your XML file.](#add-guest-access-to-the-kiosk-configuration-optional)

-When HoloLens is configured as a multi-app kiosk, only the allowed apps are available to the user. The benefit of a multi-app kiosk, or fixed-purpose device, is to provide an easy-to-understand experience for individuals by putting in front of them only the things they need to use, and removing from their view the things they don’t need to access.
+When HoloLens is configured as a multi-app kiosk, only the allowed apps are available to the user. The benefit of a multi-app kiosk, or fixed-purpose device, is to provide an easy-to-understand experience for individuals by putting in front of them only the things they need to use, and removing from their view the things they don't need to access.

 Single-app kiosk mode starts the specified app when the user signs in, and restricts the user's ability to launch new apps or change the running app. When single-app kiosk mode is enabled for HoloLens, the [start gestures](https://docs.microsoft.com/hololens/hololens2-basic-usage#start-gesture) (including [Bloom](https://docs.microsoft.com/hololens/hololens1-basic-usage) on HoloLens (1st Gen)) and Cortana are disabled, and placed apps aren't shown in the user's surroundings. 

--- a/devices/hololens/hololens-known-issues.md
+++ b/devices/hololens/hololens-known-issues.md
@ -1,11 +1,14 @@
 ---
-title: HoloLens known issues
+title: Known issues for HoloLens
 description: This is the list of known issues that may affect HoloLens developers.
 keywords: troubleshoot, known issue, help
 author: mattzmsft
 ms.author: mazeller
 ms.date: 8/30/2019
 ms.topic: article
+ms.custom: 
+- CI 111456
+- CSSTroubleshooting
 HoloLens and holograms: Frequently asked questions
 manager: jarrettr
 ms.prod: hololens
@ -13,7 +16,7 @@ appliesto:
 - HoloLens 1
 ---

-# HoloLens known issues
+# Known issues for HoloLens

 This is the current list of known issues for HoloLens that affect developers. Check here first if you are seeing an odd behavior. This list will be kept updated as new issues are discovered or reported, or as issues are addressed in future HoloLens software updates.

@ -70,7 +73,7 @@ Our team is currently working on a fix. In the meantime, you can use the followi

 1. Select **Build** > **Build Solution**.
 1. Open a Command Prompt Window and cd to the folder that contains the compiled .exe file (for example, C:\MyProjects\HoloLensDeploymentFix\bin\Debug)
-1. Run the executable and provide the device's IP address as a command-line argument. (If connected using USB, you can use 127.0.0.1, otherwise use the device’s Wi-Fi IP address.)  For example, "HoloLensDeploymentFix 127.0.0.1"
+1. Run the executable and provide the device's IP address as a command-line argument. (If connected using USB, you can use 127.0.0.1, otherwise use the device's Wi-Fi IP address.)  For example, "HoloLensDeploymentFix 127.0.0.1"

 1. After the tool has exited without any messages (this should only take a few seconds), you will now be able to deploy and debug from Visual Studio 2017 or newer.  Continued use of the tool is not necessary.

@ -84,9 +87,9 @@ We will provide further updates as they become available.
 You may experience issues when trying to launch the Microsoft Store and apps on HoloLens. We've determined that the issue occurs when background app updates deploy a newer version of framework packages in specific sequences while one or more of their dependent apps are still running. In this case,  an automatic app update delivered a new version of the .NET Native Framework (version 10.0.25531 to 10.0.27413) caused the apps that are running to not correctly update for all running apps consuming the prior version of the framework.  The flow for framework update is as follows: 

 1. The new framework package is downloaded from the store and installed
-1. All apps using the older framework are ‘updated’ to use the newer version
+1. All apps using the older framework are 'updated' to use the newer version

-If step 2 is interrupted before completion then any apps for which the newer framework wasn’t registered will fail to launch from the start menu.  We believe any app on HoloLens could be affected by this issue.
+If step 2 is interrupted before completion then any apps for which the newer framework wasn't registered will fail to launch from the start menu.  We believe any app on HoloLens could be affected by this issue.

 Some users have reported that closing hung apps and launching other apps such as Feedback Hub, 3D Viewer or Photos resolves the issue for them&mdash;however, this does not work 100% of the time.

@ -112,10 +115,10 @@ If you would not like to take the update, we have released a new version of the
 If your device is still unable to load apps, you can sideload a version of the .NET Native Framework and Runtime through the download center by following these steps:

 1. Please download [this zip file](https://download.microsoft.com/download/8/5/C/85C23745-794C-419D-B8D7-115FBCCD6DA7/netfx_1.7.zip) from the Microsoft Download Center. Unzipping will produce two files.  Microsoft.NET.Native.Runtime.1.7.appx and Microsoft.NET.Native.Framework.1.7.appx
-1. Please verify that your device is dev unlocked.  If you haven’t done that before the instructions to do that are [here](https://docs.microsoft.com/windows/mixed-reality/using-the-windows-device-portal).
+1. Please verify that your device is dev unlocked.  If you haven't done that before the instructions to do that are [here](https://docs.microsoft.com/windows/mixed-reality/using-the-windows-device-portal).
 1. You then want to get into the Windows Device Portal. Our recommendation is to do this over USB and you would do that by typing http://127.0.0.1:10080 into your browser.
-1. After you have the Windows Device Portal up we need you to “side load” the two files that you downloaded. To do that you need to go down the left side bar until you get to the **Apps** section and select **Apps**.
-1. You will then see a screen that is similar to the below.  You want to go to the section that says **Install App** and browse to where you unzipped those two APPX files. You can only do one at a time, so after you select the first one, then click on “Go” under the Deploy section. Then do this for the second APPX file.
+1. After you have the Windows Device Portal up we need you to "side load" the two files that you downloaded. To do that you need to go down the left side bar until you get to the **Apps** section and select **Apps**.
+1. You will then see a screen that is similar to the below.  You want to go to the section that says **Install App** and browse to where you unzipped those two APPX files. You can only do one at a time, so after you select the first one, then click on "Go" under the Deploy section. Then do this for the second APPX file.

   ![Windows Device Portal to Install Side-Loaded app](images/20190322-DevicePortal.png)
 1. At this point we believe your applications should start working again and that you can also get to the Store.
--- a/devices/hololens/hololens-licenses-requirements.md
+++ b/devices/hololens/hololens-licenses-requirements.md
@ -23,7 +23,7 @@ appliesto:

 If you plan on managing your HoloLens devices, you will need Azure AD and an MDM. Active Director (AD) cannot be used to manage HoloLens devices.
 If you plan on using an MDM other than Intune, an [Azure Active Directory Licenses](https://docs.microsoft.com/azure/active-directory/fundamentals/active-directory-whatis) is required.
-If you plan on using Intune as your MDM, you can acquire an [Enterprise Mobility + Security (EMS) suite (E3 or E5) licenses](https://www.microsoft.com/microsoft-365/enterprise-mobility-security/compare-plans-and-pricing). **Please note that Azure AD is included in both suites.**
+If you plan on using Intune as your MDM,  [here](https://docs.microsoft.com/intune/fundamentals/licenses) are a list of suites that includes Intune licenses. **Please note that Azure AD is included in the majority of these suites.**

 ## Identify the licenses needed for your scenario and products

@ -44,6 +44,8 @@ Make sure you have the required licensing and device. Updated licensing and prod
 1. [Teams Freemium/Teams](https://products.office.com/microsoft-teams/free)
 1. [Azure Active Directory (Azure AD) License](https://docs.microsoft.com/azure/active-directory/fundamentals/active-directory-whatis)

+If you plan on implementing **[this cross-tenant scenario](https://docs.microsoft.com/dynamics365/mixed-reality/remote-assist/cross-tenant-overview#scenario-2-leasing-services-to-other-tenants)**, you may need an Information Barriers license. Please see [this article](https://docs.microsoft.com/dynamics365/mixed-reality/remote-assist/cross-tenant-licensing-implementation#step-1-determine-if-information-barriers-are-necessary) to determine if an Information Barrier License is required.
+
 ### Guides License Requirements

 Updated licensing and device requirements can be found [here](https://docs.microsoft.com/dynamics365/mixed-reality/guides/requirements).
--- a/devices/hololens/hololens-offline.md
+++ b/devices/hololens/hololens-offline.md
@ -5,9 +5,12 @@ keywords: hololens, offline, OOBE
 audience: ITPro
 ms.date: 07/01/2019
 ms.assetid: b86f603c-d25f-409b-b055-4bbc6edcd301
-author: v-miegge
-ms.author: v-miegge
-manager: v-miegge
+author: Teresa-Motiv
+ms.author: v-tea
+ms.custom: 
+- CI 111456
+- CSSTroubleshooting
+manager: jarrettr
 ms.topic: article
 ms.prod: hololens
 ms.sitesec: library
@ -17,9 +20,9 @@ appliesto:
 - HoloLens 2
 ---

-# Manage connection endpoints for HoloLens 
+# Manage connection endpoints for HoloLens

-Some HoloLens components, apps, and related services transfer data to Microsoft network endpoints. This article lists different endpoints and URLs that need to be whitelisted in your network configuratiion (e.g. proxy or firewall) for those components to be functional.    
+Some HoloLens components, apps, and related services transfer data to Microsoft network endpoints. This article lists different endpoints and URLs that need to be whitelisted in your network configuration (e.g. proxy or firewall) for those components to be functional.    

 ## Near-offline setup

--- a/devices/hololens/hololens-provisioning.md
+++ b/devices/hololens/hololens-provisioning.md
@ -1,22 +1,32 @@
 ---
-title: Configure HoloLens using a provisioning package (HoloLens)
+title: Configure HoloLens by using a provisioning package (HoloLens)
+
 description: Windows provisioning makes it easy for IT administrators to configure end-user devices without imaging.
 ms.prod: hololens
 ms.sitesec: library
+ms.custom: 
+- CI 111456
+- CSSTroubleshooting
 author: dansimp
 ms.author: dansimp
 ms.topic: article
+ms.custom: 
+- CI 115190
+- CSSTroubleshooting
 ms.localizationpriority: medium
-ms.date: 11/13/2018
-ms.reviewer: 
+ms.date: 03/10/2020
+ms.reviewer: Teresa-Motiv
 manager: dansimp
+appliesto:
+- HoloLens (1st gen)
+- HoloLens 2
 ---

-# Configure HoloLens using a provisioning package
+# Configure HoloLens by using a provisioning package

 [Windows provisioning](https://docs.microsoft.com/windows/configuration/provisioning-packages/provisioning-packages) makes it easy for IT administrators to configure end-user devices without imaging. Windows Configuration Designer is a tool for configuring images and runtime settings which are then built into provisioning packages.

-Some of the HoloLens configurations that you can apply in a provisioning package:
+Some of the HoloLens configurations that you can apply in a provisioning package include the following:

 - Upgrade to Windows Holographic for Business [here](hololens1-upgrade-enterprise.md)
 - Set up a local account
@ -32,43 +42,42 @@ The HoloLens wizard helps you configure the following settings in a provisioning
 - Upgrade to the enterprise edition

    > [!NOTE]
-    > This should only be used for HoloLens 1st Gen devices. Settings in a provisioning package will only be applied if the provisioning package includes an edition upgrade license to Windows Holographic for Business or if [the device has already been upgraded to Windows Holographic for Business](hololens1-upgrade-enterprise.md).
+    > This should only be used for HoloLens 1st gen devices. Settings in a provisioning package are only be applied if the provisioning package includes an edition upgrade license to Windows Holographic for Business or if [the device has already been upgraded to Windows Holographic for Business](hololens1-upgrade-enterprise.md).

 - Configure the HoloLens first experience (OOBE)
- Configure Wi-Fi network
- Enroll device in Azure Active Directory or create a local account
+- Configure the Wi-Fi network
+- Enroll the device in Azure Active Directory, or create a local account
 - Add certificates
 - Enable Developer Mode
- Configure kiosk mode. (Detailed instructions for configuring kiosk mode can be found [here](hololens-kiosk.md#set-up-kiosk-mode-using-a-provisioning-package-windows-10-version-1803)).
+- Configure kiosk mode (for detailed instructions,see [Set up kiosk mode using a provisioning package](hololens-kiosk.md#set-up-kiosk-mode-using-a-provisioning-package-windows-10-version-1803)

 > [!WARNING]
 > You must run Windows Configuration Designer on Windows 10 to configure Azure Active Directory enrollment using any of the wizards.

-Provisioning packages can include management instructions and policies, customization of network connections and policies, and more.
+Provisioning packages can include management instructions and policies, custom network connections and policies, and more.

 > [!TIP]
 > Use the desktop wizard to create a package with the common settings, then switch to the advanced editor to add other settings, apps, policies, etc.

-## Steps for Creating Provisioning Packages
-
-### 1. Install Windows Configuration Designer on your PC. (There are two ways to do this).
+## Steps for creating provisioning packages

 1. **Option 1:** [From Microsoft Store](https://www.microsoft.com/store/apps/9nblggh4tx22). This includes HoloLens 2 capabilities.
 2. **Option 2:** [From the Windows Assessment and Deployment Kit (ADK) for Windows 10](https://developer.microsoft.com/windows/hardware/windows-assessment-deployment-kit). If you install Windows Configuration Designer from the Windows ADK, select **Configuration Designer** from the **Select the features you want to install** dialog box. This option does not include HoloLens 2 capabilities.

-### 2. Create the Provisioning Package
+
+### 2. Create the provisioning package

 Use the Windows Configuration Designer tool to create a provisioning package.

 1. Open Windows Configuration Designer (by default, %windir%\Program Files (x86)\Windows Kits\10\Assessment and Deployment Kit\Imaging and Configuration Designer\x86\ICD.exe).

-2. Click **Provision HoloLens devices**.
+2. Select **Provision HoloLens devices**.

   ![ICD start options](images/icd-create-options-1703.png)

-3. Name your project and click **Finish**.
+3. Name your project and select **Finish**.

-4. Read the instructions on the **Getting started** page and select **Next**. The pages for desktop provisioning will walk you through the following steps.
+4. Read the instructions on the **Getting started** page and select **Next**. The pages for desktop provisioning walk you through the following steps.
  
 > [!IMPORTANT]
 > When you build a provisioning package, you may include sensitive information in the project files and in the provisioning package (.ppkg) file. Although you have the option to encrypt the .ppkg file, project files are not encrypted. You should store the project files in a secure location and delete the project files when they are no longer needed.
@ -77,108 +86,110 @@ Use the Windows Configuration Designer tool to create a provisioning package.

 <table>
 <tr><td style="width:45%" valign="top"><a id="one"></a><img src="images/one.png" alt="step one"/><img src="images/set-up-device.png" alt="set up device"/></br></br>Browse to and select the enterprise license file to upgrade the HoloLens edition.</br></br>You can also toggle <strong>Yes</strong> or <strong>No</strong> to hide parts of the first experience.</br></br>To set up the device without the need to connect to a Wi-Fi network, toggle <strong>Skip Wi-Fi setup</strong> to <strong>On</strong>.</br></br>Select a region and timezone in which the device will be used. </td><td><img src="images/set-up-device-details.png" alt="Select enterprise licence file and configure OOBE"/></td></tr>
-<tr><td style="width:45%" valign="top"><a id="two"></a><img src="images/two.png" alt="step two"/>  <img src="images/set-up-network.png" alt="set up network"/></br></br>In this section, you can enter the details of the Wi-Fi wireless network that the device should connect to automatically. To do this, select <strong>On</strong>, enter the SSID, the network type (<strong>Open</strong> or <strong>WPA2-Personal</strong>), and (if <strong>WPA2-Personal</strong>) the password for the wireless network.</td><td><img src="images/set-up-network-details-desktop.png" alt="Enter network SSID and type"/></td></tr>
-<tr><td style="width:45%" valign="top"><a id="three"></a><img src="images/three.png" alt="step three"/>  <img src="images/account-management.png" alt="account management"/></br></br>You can enroll the device in Azure Active Directory, or create a local account on the device</br></br>Before you use a Windows Configuration Designer wizard to configure bulk Azure AD enrollment, <a href="https://docs.microsoft.com/azure/active-directory/active-directory-azureadjoin-setup" data-raw-source="[set up Azure AD join in your organization](https://docs.microsoft.com/azure/active-directory/active-directory-azureadjoin-setup)">set up Azure AD join in your organization</a>. The <strong>maximum number of devices per user</strong> setting in your Azure AD tenant determines how many times the bulk token that you get in the wizard can be used. To enroll the device in Azure AD, select that option and enter a friendly name for the bulk token you will get using the wizard. Set an expiration date for the token (maximum is 30 days from the date you get the token). Click <strong>Get bulk token</strong>. In the <strong>Let&#39;s get you signed in</strong> window, enter an account that has permissions to join a device to Azure AD, and then the password. Click <strong>Accept</strong> to give Windows Configuration Designer the necessary permissions. </br></br>To create a local account, select that option and enter a user name and password. </br></br><strong>Important:</strong> (For Windows 10, version 1607 only) If you create a local account in the provisioning package, you must change the password using the <strong>Settings</strong> app every 42 days. If the password is not changed during that period, the account might be locked out and unable to sign in.  </td><td><img src="images/account-management-details.png" alt="join  Azure AD or create a local  account"/></td></tr>
+<tr><td style="width:45%" valign="top"><a id="two"></a><img src="images/two.png" alt="step two"/>  <img src="images/set-up-network.png" alt="set up network"/></br></br>In this section, you can enter the details of the Wi-Fi wireless network that the device should automatically connect to. To do this, select <strong>On</strong>, enter the SSID, the network type (<strong>Open</strong> or <strong>WPA2-Personal</strong>), and (if <strong>WPA2-Personal</strong>) the password for the wireless network.</td><td><img src="images/set-up-network-details-desktop.png" alt="Enter network SSID and type"/></td></tr>
+<tr><td style="width:45%" valign="top"><a id="three"></a><img src="images/three.png" alt="step three"/>  <img src="images/account-management.png" alt="account management"/></br></br>You can enroll the device in Azure Active Directory, or create a local account on the device</br></br>Before you use a Windows Configuration Designer wizard to configure bulk Azure AD enrollment, <a href="https://docs.microsoft.com/azure/active-directory/active-directory-azureadjoin-setup" data-raw-source="[set up Azure AD join in your organization](https://docs.microsoft.com/azure/active-directory/active-directory-azureadjoin-setup)">set up Azure AD join in your organization</a>. The <strong>maximum number of devices per user</strong> setting in your Azure AD tenant determines how many times the bulk token that you get in the wizard can be used. To enroll the device in Azure AD, select that option and enter a friendly name for the bulk token you will get using the wizard. Set an expiration date for the token (maximum is 30 days from the date you get the token). Select <strong>Get bulk token</strong>. In the <strong>Let&#39;s get you signed in</strong> window, enter an account that has permissions to join a device to Azure AD, and then the password. Select <strong>Accept</strong> to give Windows Configuration Designer the necessary permissions. </br></br>To create a local account, select that option and enter a user name and password. </br></br><strong>Important:</strong> <br />(For Windows 10, version 1607 only) If you create a local account in the provisioning package, you must change the password using the <strong>Settings</strong> app every 42 days. If the password is not changed during that period, the account might be locked out and unable to sign in.  </td><td><img src="images/account-management-details.png" alt="join  Azure AD or create a local  account"/></td></tr>
 <tr><td style="width:45%" valign="top"><a id="four"></a><img src="images/four.png" alt="step four"/> <img src="images/add-certificates.png" alt="add certificates"/></br></br>To provision the device with a certificate, click <strong>Add a certificate</strong>. Enter a name for the certificate, and then browse to and select the certificate to be used.</td><td><img src="images/add-certificates-details.png" alt="add a certificate"/></td></tr> 
 <tr><td style="width:45%" valign="top"><a id="five"></a><img src="images/five.png" alt="step five"/> <img src="images/developer-setup.png" alt="Developer Setup"/></br></br>Toggle <strong>Yes</strong> or <strong>No</strong> to enable Developer Mode on the HoloLens. <a href="https://docs.microsoft.com/windows/uwp/get-started/enable-your-device-for-development#developer-mode" data-raw-source="[Learn more about Developer Mode.](https://docs.microsoft.com/windows/uwp/get-started/enable-your-device-for-development#developer-mode)">Learn more about Developer Mode.</a></td><td><img src="images/developer-setup-details.png" alt="Enable Developer Mode"/></td></tr>
 <tr><td style="width:45%" valign="top"><a id="six"></a><img src="images/six.png" alt="step six"/> <img src="images/finish.png" alt="finish"/></br></br>Do not set a password to protect your provisioning package. If the provisioning package is protected by a password, provisioning the HoloLens device will fail.</td><td><img src="images/finish-details.png" alt="Protect your package"/></td></tr>
 </table>

-After you're done, click **Create**. It only takes a few seconds. When the package is built, the location where the package is stored is displayed as a hyperlink at the bottom of the page.
+After you're done, select **Create**. It only takes a few seconds. When the package is built, the location where the package is stored is displayed as a hyperlink at the bottom of the page.

-### 3. Create a provisioning package for HoloLens using advanced provisioning
+### 3. Create a provisioning package for HoloLens by using advanced provisioning

 > [!NOTE]
-> Settings in a provisioning package will only be applied if the provisioning package includes an edition upgrade license to Windows Holographic for Business or if [the device has already been upgraded to Windows Holographic for Business](hololens1-upgrade-enterprise.md).
+> A provisioning package that you create in **Advanced provisioning** does not need to include an edition upgrade license to Windows Holographic for Business to succesfully apply to a HoloLens (1st gen). [See more on Windows Holographic for Business for HoloLens (1st gen)](hololens1-upgrade-enterprise.md).

 1. On the Windows Configuration Designer start page, select **Advanced provisioning**.
 2. In the **Enter project details** window, specify a name for your project and the location for your project. Optionally, enter a brief description to describe your project.

-3. Click **Next**.
+3. Select **Next**.

-4. In the **Choose which settings to view and configure** window, select **Windows 10 Holographic**, and then click **Next**.
+4. In the **Choose which settings to view and configure** window, select **Windows 10 Holographic**, and then select **Next**.

-6. Click **Finish**.
+5. Select **Finish**.

-7. Expand **Runtime settings** and customize the package with any of the settings [described below](#what-you-can-configure).
+6. Expand **Runtime settings** and customize the package by using any of the settings [described later in this article](#what-you-can-configure).

    > [!IMPORTANT]
    > (For Windows 10, version 1607 only) If you create a local account in the provisioning package, you must change the password using the **Settings** app every 42 days. If the password is not changed during that period, the account might be locked out and unable to sign in. If the user account is locked out, you must [perform a full device recovery](https://developer.microsoft.com/windows/mixed-reality/reset_or_recover_your_hololens#perform_a_full_device_recovery).

-8. On the **File** menu, click **Save**.
+7. Select **File** > **Save**.

-4. Read the warning that project files may contain sensitive information, and click **OK**.
+8. Read the warning that project files may contain sensitive information, and select **OK**.

    > [!IMPORTANT]
    > When you build a provisioning package, you may include sensitive information in the project files and in the provisioning package (.ppkg) file. Although you have the option to encrypt the .ppkg file, project files are not encrypted. You should store the project files in a secure location and delete the project files when they are no longer needed.
    
-3. On the **Export** menu, click **Provisioning package**.
+9. Select **Export** > **Provisioning package**.

-4. Change **Owner** to **IT Admin**, which will set the precedence of this provisioning package higher than provisioning packages applied to this device from other sources, and then select **Next**.
+10. Change **Owner** to **IT Admin**. This sets the precedence of this provisioning package higher than provisioning packages applied to this device from other sources. Select **Next**.

-5. Set a value for **Package Version**.
+11. Set a value for **Package Version**.

    > [!TIP]
    > You can make changes to existing packages and change the version number to update previously applied packages.

-6. On the **Select security details for the provisioning package**, click **Next**.
+12. On the **Select security details for the provisioning package**, select **Next**.

    > [!WARNING]
    > If you encrypt the provisioning package, provisioning the HoloLens device will fail.  

-7. Click **Next** to specify the output location where you want the provisioning package to go once it's built. By default, Windows Configuration Designer uses the project folder as the output location.
+13. Select **Next** to specify the output location where you want the provisioning package to go once it's built. By default, Windows Configuration Designer uses the project folder as the output location.

-    Optionally, you can click **Browse** to change the default output location.
+    Optionally, you can select **Browse** to change the default output location.

-8. Click **Next**.
+14. Select **Next**.

-9. Click **Build** to start building the package. The project information is displayed in the build page and the progress bar indicates the build status.
+15. Select **Build** to start building the package. The project information is displayed in the build page and the progress bar indicates the build status.

-10. When the build completes, click **Finish**.
+16. When the build completes, select **Finish**.

 <span id="apply" />

 ## Apply a provisioning package to HoloLens during setup

-1. Connect the device via USB to a PC and start the device, but do not continue past the **Fit** page of OOBE (the first page with the blue box).
+1. Use the USB cable to connect the device to a PC, and then start the device. Do not continue past the **First interactable moment** page of OOBE.   
+    - On HoloLens (1st gen), this page contains a blue box. 
+    - On HoloLens 2, this page contains the hummingbird.

-2. Briefly press and release the **Volume Down** and **Power** buttons simultaneously. (This step isn't needed in Windows 10, version 1803.)
+2. Briefly press and release the **Volume Down** and **Power** buttons simultaneously. 

-3. HoloLens will show up as a device in File Explorer on the PC.
+3. HoloLens shows up as a device in File Explorer on the PC.

 4. In File Explorer, drag and drop the provisioning package (.ppkg) onto the device storage.

 5. Briefly press and release the **Volume Down** and **Power** buttons simultaneously again while on the **fit** page.

-6. The device will ask you if you trust the package and would like to apply it. Confirm that you trust the package.
+6. The device asks you if you trust the package and would like to apply it. Confirm that you trust the package.

 7. You will see whether the package was applied successfully or not. If it failed, you can fix your package and try again. If it succeeded, proceed with OOBE.

 > [!NOTE]
-> If the device was purchased before August 2016, you will need to sign into the device with a Microsoft account, get the latest OS update, and then reset the OS in order to apply the provisioning package.
+> If the device was purchased before August 2016, you will need to sign in to the device by using a Microsoft account, get the latest operating system update, and then reset the operating system in order to apply the provisioning package.

 ### 4. Apply a provisioning package to HoloLens after setup

 > [!NOTE]
-> Windows 10, version 1809 only
+> These steps apply only toWindows 10, version 1809.

-On your PC:
+On your PC, follow these steps:
 1. Create a provisioning package as described at [Create a provisioning package for HoloLens using the HoloLens wizard](hololens-provisioning.md).
-2. Connect the HoloLens device via USB to a PC. HoloLens will show up as a device in File Explorer on the PC.
+2. Connect the HoloLens device to a PC by using a USB cable. HoloLens shows up as a device in File Explorer on the PC.
 3. Drag and drop the provisioning package to the Documents folder on the HoloLens.

-On your HoloLens:
-1. Go to **Settings > Accounts > Access work or school**. 
+On your HoloLens, follow these steps:
+1. Go to **Settings** > **Accounts** > **Access work or school**. 
 2. In **Related Settings**, select **Add or remove a provisioning package**.
 3. On the next page, select **Add a package** to launch the file picker and select your provisioning package. If the folder is empty, make sure you select **This Device** and select **Documents**.

-After your package has been applied, it will show in the list of **Installed packages**. To view package details or to remove the package from the device, select the listed package.
+After your package has been applied, it shows up in the list of **Installed packages**. To view the package details or to remove the package from the device, select the listed package.

 ## What you can configure

-Provisioning packages make use of configuration service providers (CSPs). If you're not familiar with CSPs, see [Introduction to configuration service providers (CSPs) for IT pros](https://technet.microsoft.com/itpro/windows/manage/how-it-pros-can-use-configuration-service-providers).
+Provisioning packages make use of configuration service providers (CSPs). If you're not familiar with CSPs, see [Introduction to configuration service providers (CSPs) for IT pros](https://docs.microsoft.com/windows/configuration/provisioning-packages/how-it-pros-can-use-configuration-service-providers).

-In Windows Configuration Designer, when you create a provisioning package for Windows Holographic, the settings in **Available customizations** are based on [CSPs that are supported in Windows Holographic](https://msdn.microsoft.com/windows/hardware/commercialize/customize/mdm/configuration-service-provider-reference#hololens). The following table describes settings that you might want to configure for HoloLens.
+In Windows Configuration Designer, when you create a provisioning package for Windows Holographic, the settings in **Available customizations** are based on [CSPs that are supported in Windows Holographic](https://docs.microsoft.com/windows/client-management/mdm/configuration-service-provider-reference#csps-supported-in-hololens-devices). The following table describes settings that you might want to configure for HoloLens.

 ![Common runtime settings for HoloLens](images/icd-settings.png)

@ -187,9 +198,9 @@ In Windows Configuration Designer, when you create a provisioning package for Wi
 | **Certificates** | Deploy a certificate to HoloLens.  |
 | **ConnectivityProfiles** | Deploy a Wi-Fi profile to HoloLens.   |
 | **EditionUpgrade** | [Upgrade to Windows Holographic for Business.](hololens1-upgrade-enterprise.md)  |
-| **Policies** | Allow or prevent developer mode on HoloLens. [Policies supported by Windows Holographic for Business](https://msdn.microsoft.com/windows/hardware/commercialize/customize/mdm/policy-configuration-service-provider#hololenspolicies) |
+| **Policies** | Allow or prevent developer mode on HoloLens. [Policies supported by Windows Holographic for Business](https://docs.microsoft.com/windows/client-management/mdm/policy-configuration-service-provider#hololenspolicies) |

 > [!NOTE]
-> App installation (**UniversalAppInstall**) using a provisioning package is not currently supported for HoloLens.
+> HoloLens does not currently support installing apps (**UniversalAppInstall**) by using a provisioning package.

 ## Next Step: [Enroll your device](hololens-enroll-mdm.md)
--- a/devices/hololens/hololens-recovery.md
+++ b/devices/hololens/hololens-recovery.md
@ -1,5 +1,5 @@
 ---
-title: Reset or recover your HoloLens 
+title: Restart, reset, or recover HoloLens
 ms.reviewer: Both basic and advanced instructions for rebooting or resetting your HoloLens.
 description: How to use Advanced Recovery Companion to flash an image to HoloLens 2.
 keywords: how-to, reboot, reset, recover, hard reset, soft reset, power cycle, HoloLens, shut down, arc, advanced recovery companion
@ -8,6 +8,9 @@ ms.sitesec: library
 author: mattzmsft
 ms.author: mazeller
 ms.date: 08/30/2019
+ms.custom: 
+- CI 111456
+- CSSTroubleshooting
 ms.topic: article
 ms.localizationpriority: high
 manager: jarrettr
@ -18,9 +21,9 @@ appliesto:

 # Restart, reset, or recover HoloLens

-If you’re experiencing problems with your HoloLens you may want to try a restart, reset, or even re-flash with device recovery.
+If you're experiencing problems with your HoloLens you may want to try a restart, reset, or even re-flash with device recovery.

-Here are some things to try if your HoloLens isn’t running well.  This article will guide you through the recommended recovery steps in succession.
+Here are some things to try if your HoloLens isn't running well.  This article will guide you through the recommended recovery steps in succession.

 This article focuses on the HoloLens device and software, if your holograms don't look right, [this article](hololens-environment-considerations.md) talks about environmental factors that improve hologram quality.

@ -33,9 +36,9 @@ First, try restarting the device.
 The safest way to restart the HoloLens is by using Cortana. This is generally a great first-step when experiencing an issue with HoloLens:

 1. Put on your device
-1. Make sure it’s powered on, a user is logged in, and the device is not waiting for a password to unlock it.
-1. Say “Hey Cortana, reboot” or "Hey Cortana, restart."
-1. When she acknowledges she will ask you for confirmation. Wait a second for a sound to play after she has finished her question, indicating she is listening to you and then say “Yes.”
+1. Make sure it's powered on, a user is logged in, and the device is not waiting for a password to unlock it.
+1. Say "Hey Cortana, reboot" or "Hey Cortana, restart."
+1. When she acknowledges she will ask you for confirmation. Wait a second for a sound to play after she has finished her question, indicating she is listening to you and then say "Yes."
 1. The device will now restart.

 ### Perform a safe restart by using the power button
@ -45,7 +48,7 @@ If you still can't restart your device, you can try to restart it by using the p
 1. Press and hold the power button for five seconds.
   1. After one second, you will see all five LEDs illuminate, then slowly turn off from right to left.
   1. After five seconds, all LEDs will be off, indicating the shutdown command was issued successfully.
-   1. Note that it’s important to stop pressing the button immediately after all the LEDs have turned off.
+   1. Note that it's important to stop pressing the button immediately after all the LEDs have turned off.
 1. Wait one minute for the shutdown to cleanly succeed. Note that the shutdown may still be in progress even if the displays are turned off.
 1. Power on the device again by pressing and holding the power button for one second.

@ -66,18 +69,18 @@ If none of the previous methods are able to successfully restart your device, yo

 1. Press and hold the power button for at least 10 seconds.

-   - It’s okay to hold the button for longer than 10 seconds.
-   - It’s safe to ignore any LED activity.
+   - It's okay to hold the button for longer than 10 seconds.
+   - It's safe to ignore any LED activity.
 1. Release the button and wait for two or three seconds.
 1. Power on the device again by pressing and holding the power button for one second.
-If you’re still having problems, press the power button for 4 seconds, until all of the battery indicators fade out and the screen stops displaying holograms. Wait 1 minute, then press the power button again to turn on the device.
+If you're still having problems, press the power button for 4 seconds, until all of the battery indicators fade out and the screen stops displaying holograms. Wait 1 minute, then press the power button again to turn on the device.

 ## Reset to factory settings

 > [!NOTE]
 > The battery needs at least 40 percent charge to reset.

-If your HoloLens is still experiencing issues after restarting, try resetting it to factory state.  Resetting your HoloLens keeps the version of the Windows Holographic software that’s installed on it and returns everything else to factory settings.
+If your HoloLens is still experiencing issues after restarting, try resetting it to factory state.  Resetting your HoloLens keeps the version of the Windows Holographic software that's installed on it and returns everything else to factory settings.

 If you reset your device, all your personal data, apps, and settings will be erased. Resetting will only install the latest installed version of Windows Holographic and you will have to redo all the initialization steps (calibrate, connect to Wi-Fi, create a user account, download apps, and so forth).

@ -109,10 +112,10 @@ The Advanced Recovery Companion is a new app in Microsoft Store restore the oper
 > [!TIP]
 > In the event that a HoloLens 2 gets into a state where Advanced Recovery Companion cannot recognize the device, and it does not boot, try forcing the device into Flashing Mode and recovering it with Advanced Recovery Companion:

-1.	Connect the HoloLens 2 to a PC with Advanced Recovery Companion installed.
-1.	Press and hold the **Volume Up and Power buttons** until the device reboots.  Release the Power button, but continue to hold the Volume Up button until the third LED is lit.
-1.	The device should be visible in **Device Manager** as a **Microsoft HoloLens Recovery** device.
-1.	Launch Advanced Recovery Companion, and follow the on-screen prompts to reflash the OS to the HoloLens 2.
+1.    Connect the HoloLens 2 to a PC with Advanced Recovery Companion installed.
+1.    Press and hold the **Volume Up and Power buttons** until the device reboots.  Release the Power button, but continue to hold the Volume Up button until the third LED is lit.
+1.    The device should be visible in **Device Manager** as a **Microsoft HoloLens Recovery** device.
+1.    Launch Advanced Recovery Companion, and follow the on-screen prompts to reflash the OS to the HoloLens 2.

 ### HoloLens (1st gen)

@ -120,7 +123,7 @@ If necessary, you can install a completely new operating system on your HoloLens

 Before you use this tool, determine if restarting or resetting your HoloLens fixes the problem. The recovery process may take some time.  When you're done, the latest version of the Windows Holographic software approved for your HoloLens will be installed.

-To use the tool, you’ll need a computer running Windows 10 or later, with at least 4 GB of free storage space.  Please note that you can’t run this tool on a virtual machine.
+To use the tool, you'll need a computer running Windows 10 or later, with at least 4 GB of free storage space.  Please note that you can't run this tool on a virtual machine.

 To recover your HoloLens

@ -128,4 +131,4 @@ To recover your HoloLens
 1. Connect the HoloLens (1st gen) to your computer using the Micro USB cable that came with your HoloLens.
 1. Run the Windows Device Recovery Tool and follow the instructions.

-If the HoloLens (1st gen) isn’t automatically detected, select **My device was not detected** and follow the instructions to put your device into recovery mode.
+If the HoloLens (1st gen) isn't automatically detected, select **My device was not detected** and follow the instructions to put your device into recovery mode.
--- a/devices/hololens/hololens-release-notes.md
+++ b/devices/hololens/hololens-release-notes.md
@ -1,5 +1,5 @@
 ---
-title: What's new in Microsoft HoloLens
+title: HoloLens release notes
 description: Learn about updates in each new HoloLens release.
 author: scooley
 ms.author: scooley
@ -9,6 +9,9 @@ ms.sitesec: library
 ms.topic: article
 ms.localizationpriority: medium
 ms.date: 12/02/2019
+ms.custom: 
+- CI 111456
+- CSSTroubleshooting
 audience: ITPro
 appliesto:
 - HoloLens 1
@ -16,7 +19,7 @@ appliesto:

 ---

-# HoloLens Release Notes
+# HoloLens release notes

 ## HoloLens 2

@ -57,12 +60,12 @@ appliesto:
 | Feature | Details |
 |---|---|
 | **Quick actions menu** | When you're in an app, the Bloom gesture will now open a Quick actions menu to give you quick access to commonly used system features without having to leave the app. <br> See [Set up HoloLens in kiosk mode](hololens-kiosk.md) for information about the Quick actions menu in kiosk mode.<br><br>![sample of the Quick actions menu](images/minimenu.png) |
-| **Stop video capture from the Start or quick actions menu** | If you start video capture from the Start menu or quick actions menu, you’ll be able to stop recording from the same place. (Don’t forget, you can always do this with voice commands too.) |
+| **Stop video capture from the Start or quick actions menu** | If you start video capture from the Start menu or quick actions menu, you'll be able to stop recording from the same place. (Don't forget, you can always do this with voice commands too.) |
 | **Project to a Miracast-enabled device** | Project your HoloLens content to a nearby Surface device or TV/Monitor if using Microsoft Display adapter.  On **Start**, select **Connect**, and then select the device you want to project to. **Note:** You can deploy HoloLens to use Miracast projection without enabling developer mode. |
-| **New notifications** | View and respond to notification toasts on HoloLens, just like you do on a PC. Gaze to respond to or dismiss them (or if you’re in an immersive experience, use the bloom gesture). |
-| **HoloLens overlays**<br>(file picker, keyboard, dialogs, etc.) | You’ll now see overlays such as the keyboard, dialogs, file picker, etc. when using immersive apps. |
-| **Visual feedback overlay UI for volume change** | When you use the volume up/down buttons on your HoloLens you’ll see a visual display of the volume level. |
-| **New UI for device boot** | A loading indicator was added during the boot process to provide visual feedback that the system is loading. Reboot your device to see the new loading indicator—it’s between the "Hello" message and the Windows boot logo. |
+| **New notifications** | View and respond to notification toasts on HoloLens, just like you do on a PC. Gaze to respond to or dismiss them (or if you're in an immersive experience, use the bloom gesture). |
+| **HoloLens overlays**<br>(file picker, keyboard, dialogs, etc.) | You'll now see overlays such as the keyboard, dialogs, file picker, etc. when using immersive apps. |
+| **Visual feedback overlay UI for volume change** | When you use the volume up/down buttons on your HoloLens you'll see a visual display of the volume level. |
+| **New UI for device boot** | A loading indicator was added during the boot process to provide visual feedback that the system is loading. Reboot your device to see the new loading indicator—it's between the "Hello" message and the Windows boot logo. |
 | **Nearby sharing** | Addition of the Windows Nearby Sharing experience, allowing you to share a capture with a nearby Windows device. When you capture a photo or video on HoloLens (or use the share button from an app such as Microsoft Edge), select a nearby Windows device to share with. |
 | **Share from Microsoft Edge** | Share button is now available on Microsoft Edge windows on HoloLens. In Microsoft Edge, select **Share**. Use the HoloLens share picker to share web content. |

--- a/devices/hololens/hololens-requirements.md
+++ b/devices/hololens/hololens-requirements.md
@ -33,7 +33,7 @@ This document also assumes that the HoloLens has been evaluated by security team

 Before deploying the HoloLens in your environment, it is important to first determine what features, apps, and type of identities are needed. It is also important to ensure that your security team has approved of the use of the HoloLens on the company's network. Please see [Frequently ask security questions](hololens-faq-security.md) for additional security information.

-### Type of identity
+### Type of Identity

 Determine the type of identity that will be used to sign into the device.

@ -41,6 +41,8 @@ Determine the type of identity that will be used to sign into the device.
 2. **MSA:** This is a personal account (like outlook, hotmail, gmail, yahoo, etc.) This will allow only 1 user to log into the device.
 3. **Azure Active Directory (Azure AD) accounts:** This is an account created in Azure AD. This grants your corporation the ability to manage the HoloLens device. This will allow multiple users to log into the HoloLens 1st Gen Commercial Suite/the HoloLens 2 device.

+For more detailed information about identity types, please visit our [HoloLens Identity](hololens-identity.md) article.
+
 ### Type of Features

 Your feature requirements will determine which HoloLens you need. One popular feature that we see deployed in customer environments frequently is Kiosk Mode. A list of HoloLens key features, and the editions of HoloLens that support them, can be found [here](hololens-commercial-features.md).
@ -66,13 +68,15 @@ There are two types of Kiosk Modes: Single app and multi-app. Single app kiosk m

 There are two main ways ([provisioning packages](hololens-kiosk.md#set-up-kiosk-mode-using-a-provisioning-package-windows-10-version-1803) and [MDM](hololens-kiosk.md#set-up-kiosk-mode-using-microsoft-intune-or-mdm-windows-10-version-1803)) to deploy kiosk mode for HoloLens. These options will be discussed later in the document; however, you can use the links above to jump to the respective sections in this doc.

-### Apps
+### Apps and App Specific Scenarios

 The majority of the steps found in this document will also apply to the following apps:

-1. Remote Assist
-2. Guides
-3. Customer Apps
+| App | App Specific Scenarios |
+| --- | --- |
+| Remote Assist | [Cross Tenant Communication](https://docs.microsoft.com/dynamics365/mixed-reality/remote-assist/cross-tenant-overview)|
+| Guides  | *Coming Soon* |
+|Custom Apps | *Coming Soon* |

 ### Determine your enrollment method

--- a/devices/hololens/hololens-spaces.md
+++ b/devices/hololens/hololens-spaces.md
@ -1,9 +1,12 @@
 ---
-title: Mapping physical spaces with HoloLens
+title: Map physical spaces with HoloLens
 description: HoloLens learns what a space looks like over time. Users can facilitate this process by moving the HoloLens in certain ways through the space.
 ms.assetid: bd55ecd1-697a-4b09-8274-48d1499fcb0b
 author: dorreneb
 ms.author: dobrown
+ms.custom: 
+- CI 111456
+- CSSTroubleshooting
 ms.date: 09/16/2019
 keywords: hololens, Windows Mixed Reality, design, spatial mapping, HoloLens, surface reconstruction, mesh, head tracking, mapping
 ms.prod: hololens
@ -15,14 +18,14 @@ appliesto:
 - HoloLens 2
 ---

-# Mapping physical spaces with HoloLens
+# Map physical spaces with HoloLens

 HoloLens blends holograms with your physical world. To do that, HoloLens has to learn about the physical world around you and remember where you place holograms within that space.

 Over time, the HoloLens builds up a *spatial map* of the environment that it has seen.  HoloLens updates the map as the environment changes. As long as you are logged in and the device is turned on, HoloLens creates and updates your spatial maps. If you hold or wear the device with the cameras pointed at a space, the HoloLens tries to map the area. While the HoloLens learns a space naturally over time, there are ways in which you can help HoloLens map your space more quickly and efficiently.  

 > [!NOTE]
-> If your HoloLens can’t map your space or is out of calibration, HoloLens may enter Limited mode. In Limited mode, you won’t be able to place holograms in your surroundings.
+> If your HoloLens can't map your space or is out of calibration, HoloLens may enter Limited mode. In Limited mode, you won't be able to place holograms in your surroundings.

 This article explains how HoloLens maps spaces, how to improve spatial mapping, and how to manage the spatial data that HoloLens collects.

--- a/devices/hololens/hololens-status.md
+++ b/devices/hololens/hololens-status.md
@ -1,18 +1,21 @@
 ---
-title: HoloLens status
+title: Status of the HoloLens services
 description: Shows the status of HoloLens online services. 
-author: todmccoy
-ms.author: v-todmc
+author: Teresa-Motiv
+ms.author: v-tea
 ms.reviewer: luoreill
 manager: jarrettr
 audience: Admin
+ms.custom: 
+- CI 111456
+- CSSTroubleshooting
 ms.topic: article
 ms.prod: hololens
 ms.localizationpriority: high
 ms.sitesec: library
 ---

-# HoloLens status
+# Status of the HoloLens services

 ✔️ **All services are active**

--- a/devices/hololens/hololens-troubleshooting.md
+++ b/devices/hololens/hololens-troubleshooting.md
@ -1,5 +1,5 @@
 ---
-title: HoloLens troubleshooting
+title: Troubleshoot HoloLens issues
 description: Solutions for common HoloLens issues.
 author: mattzmsft
 ms.author: mazeller
@ -11,16 +11,19 @@ audience: ITPro
 ms.localizationpriority: medium
 keywords: issues, bug, troubleshoot, fix, help, support, HoloLens
 manager: jarrettr
+ms.custom: 
+- CI 111456
+- CSSTroubleshooting
 appliesto:
 - HoloLens (1st gen)
 - HoloLens 2
 ---

-# Troubleshooting HoloLens issues
+# Troubleshoot HoloLens issues

 This article describes how to resolve several common HoloLens issues.

-## My HoloLens is unresponsive or won’t start
+## My HoloLens is unresponsive or won't start

 If your HoloLens won't start:

@ -35,59 +38,59 @@ If these steps don't work, you can try [recovering your device](hololens-recover

 ## Holograms don't look good

-If your holograms are unstable, jumpy, or don’t look right, try:
+If your holograms are unstable, jumpy, or don't look right, try:

 - Cleaning your device visor and sensor bar on the front of your HoloLens.
 - Increasing the light in your room.
 - Walking around and looking at your surroundings so that HoloLens can scan them more completely.
 - Calibrating your HoloLens for your eyes. Go to **Settings** > **System** > **Utilities**. Under **Calibration**, select **Open Calibration**.

-## HoloLens doesn’t respond to gestures
+## HoloLens doesn't respond to gestures

 To make sure that HoloLens can see your gestures.  Keep your hand in the gesture frame - when HoloLens can see your hand, the cursor changes from a dot to a ring.

 Learn more about using gestures on [HoloLens (1st gen)](hololens1-basic-usage.md#use-hololens-with-your-hands) or [HoloLens 2](hololens2-basic-usage.md#the-hand-tracking-frame).

-If your environment is too dark, HoloLens might not see your hand, so make sure that there’s enough light.
+If your environment is too dark, HoloLens might not see your hand, so make sure that there's enough light.

 If your visor has fingerprints or smudges, use the microfiber cleaning cloth that came with the HoloLens to clean your visor gently.

-## HoloLens doesn’t respond to my voice commands
+## HoloLens doesn't respond to my voice commands

-If Cortana isn’t responding to your voice commands, make sure Cortana is turned on. On the All apps list, select **Cortana** > **Menu** > **Notebook** > **Settings** to make changes. To learn more about what you can say, see [Use your voice with HoloLens](hololens-cortana.md).
+If Cortana isn't responding to your voice commands, make sure Cortana is turned on. On the All apps list, select **Cortana** > **Menu** > **Notebook** > **Settings** to make changes. To learn more about what you can say, see [Use your voice with HoloLens](hololens-cortana.md).

-## I can’t place holograms or see holograms that I previously placed
+## I can't place holograms or see holograms that I previously placed

-If HoloLens can’t map or load your space, it enters Limited mode and you won’t be able to place holograms or see holograms that you’ve placed. Here are some things to try:
+If HoloLens can't map or load your space, it enters Limited mode and you won't be able to place holograms or see holograms that you've placed. Here are some things to try:

- Make sure that there’s enough light in your environment so HoloLens can see and map the space.
- Make sure that you’re connected to a Wi-Fi network. If you’re not connected to Wi-Fi, HoloLens can’t identify and load a known space.
+- Make sure that there's enough light in your environment so HoloLens can see and map the space.
+- Make sure that you're connected to a Wi-Fi network. If you're not connected to Wi-Fi, HoloLens can't identify and load a known space.
 - If you need to create a new space, connect to Wi-Fi, then restart your HoloLens.
 - To see if the correct space is active, or to manually load a space, go to **Settings** > **System** > **Spaces**.
- If the correct space is loaded and you’re still having problems, the space may be corrupt. To fix this issue, select the space, then select **Remove**. After you remove the space, HoloLens starts to map your surroundings and create a new space.
+- If the correct space is loaded and you're still having problems, the space may be corrupt. To fix this issue, select the space, then select **Remove**. After you remove the space, HoloLens starts to map your surroundings and create a new space.

-## My HoloLens can’t tell what space I’m in
+## My HoloLens can't tell what space I'm in

-If your HoloLens can’t identify and load the space you’re in automatically, check the following factors:
+If your HoloLens can't identify and load the space you're in automatically, check the following factors:

- Make sure that you’re connected to Wi-Fi
- Make sure that there’s plenty of light in the room
- Make sure that there haven’t been any major changes to the surroundings.
+- Make sure that you're connected to Wi-Fi
+- Make sure that there's plenty of light in the room
+- Make sure that there haven't been any major changes to the surroundings.

 You can also load a space manually or manage your spaces by going to **Settings** > **System** > **Spaces**.

-## I’m getting a “low disk space” error
+## I'm getting a "low disk space" error

-You’ll need to free up some storage space by doing one or more of the following:
+You'll need to free up some storage space by doing one or more of the following:

 - Delete some unused spaces. Go to **Settings** > **System** > **Spaces**, select a space that you no longer need, and then select **Remove**.
- Remove some of the holograms that you’ve placed.
+- Remove some of the holograms that you've placed.
 - Delete some pictures and videos from the Photos app.
 - Uninstall some apps from your HoloLens. In the **All apps** list, tap and hold the app you want to uninstall, and then select **Uninstall**.

-## My HoloLens can’t create a new space
+## My HoloLens can't create a new space

-The most likely problem is that you’re running low on storage space. Try one of the [previous tips](#im-getting-a-low-disk-space-error) to free up some disk space.
+The most likely problem is that you're running low on storage space. Try one of the [previous tips](#im-getting-a-low-disk-space-error) to free up some disk space.

 ## The HoloLens emulators isn't working

--- a/devices/hololens/hololens-updates.md
+++ b/devices/hololens/hololens-updates.md
@ -1,5 +1,5 @@
 ---
-title: Managing updates to HoloLens
+title: Manage HoloLens updates
 description: Administrators can use mobile device management to manage updates to HoloLens devices.
 ms.prod: hololens
 ms.sitesec: library
@ -11,12 +11,15 @@ ms.localizationpriority: high
 ms.date: 11/7/2019
 ms.reviewer: jarrettr
 manager: jarrettr
+ms.custom: 
+- CI 111456
+- CSSTroubleshooting
 appliesto:
 - HoloLens (1st gen)
 - HoloLens 2
 ---

-# Managing HoloLens updates
+# Manage HoloLens updates

 HoloLens uses Windows Update, just like other Windows 10 devices. When an update is available, it will be automatically downloaded and installed the next time your device is plugged in and connected to the Internet.

--- a/devices/hololens/hololens-whats-new.md
+++ b/devices/hololens/hololens-whats-new.md
@ -1,85 +0,0 @@
---
-title: What's new in Microsoft HoloLens (HoloLens)
-description: Windows Holographic for Business gets new features in Windows 10, version 1809.
-ms.prod: hololens
-ms.sitesec: library
-author: dansimp
-ms.author: dansimp
-ms.topic: article
-ms.localizationpriority: medium
-ms.date: 11/13/2018
-ms.reviewer: 
-manager: dansimp
---
-
-# What's new in Microsoft HoloLens
-
-## Windows 10, version 1809 for Microsoft HoloLens
-
-> **Applies to:** Hololens (1st gen)
-
-### For everyone
-
-| Feature | Details |
-|---|---|
-| **Quick actions menu** | When you're in an app, the Bloom gesture will now open a Quick actions menu to give you quick access to commonly used system features without having to leave the app. <br> See [Set up HoloLens in kiosk mode](hololens-kiosk.md) for information about the Quick actions menu in kiosk mode.<br><br>![sample of the Quick actions menu](images/minimenu.png) |
-| **Stop video capture from the Start or quick actions menu** | If you start video capture from the Start menu or quick actions menu, you’ll be able to stop recording from the same place. (Don’t forget, you can always do this with voice commands too.) |
-| **Project to a Miracast-enabled device** | Project your HoloLens content to a nearby Surface device or TV/Monitor if using Microsoft Display adapter.  On **Start**, select **Connect**, and then select the device you want to project to. **Note:** You can deploy HoloLens to use Miracast projection without enabling developer mode. |
-| **New notifications** | View and respond to notification toasts on HoloLens, just like you do on a PC. Gaze to respond to or dismiss them (or if you’re in an immersive experience, use the bloom gesture). |
-| **HoloLens overlays**<br>(file picker, keyboard, dialogs, etc.) | You’ll now see overlays such as the keyboard, dialogs, file picker, etc. when using immersive apps. |
-| **Visual feedback overlay UI for volume change** | When you use the volume up/down buttons on your HoloLens you’ll see a visual display of the volume level. |
-| **New UI for device boot** | A loading indicator was added during the boot process to provide visual feedback that the system is loading. Reboot your device to see the new loading indicator—it’s between the "Hello" message and the Windows boot logo. |
-| **Nearby sharing** | Addition of the Windows Nearby Sharing experience, allowing you to share a capture with a nearby Windows device. When you capture a photo or video on HoloLens (or use the share button from an app such as Microsoft Edge), select a nearby Windows device to share with. |
-| **Share from Microsoft Edge** | Share button is now available on Microsoft Edge windows on HoloLens. In Microsoft Edge, select **Share**. Use the HoloLens share picker to share web content. |
-
-### For administrators
-
-| Feature |  Details  |
-|---|----|
-|         [Enable post-setup provisioning](hololens-provisioning.md)          |                                                                                                                                   You can now apply a runtime provisioning package at any time using **Settings**.                                                                                                                                   |
-|                    Assigned access with Azure AD groups                     |                                                                                                           You can now use Azure AD groups for configuration of Windows assigned access to set up single or multi-app kiosk configuration.                                                                                                            |
-|              PIN sign-in on profile switch from sign-in screen              |                                                                                                                                                  PIN sign-in is now available for **Other User**.                                                                                                                                                    |
-|             Sign in with Web Credential Provider using password             | You can now select the Globe sign-in option to launch web sign-in with your password. From the sign-in screen, select **Sign-In options** and select the Globe option to launch web sign-in. Enter your user name if needed, then your password. <br>**Note:** You can choose to bypass any PIN/Smartcard options when prompted during web sign-in.  |
-| Read device hardware info through MDM so devices can be tracked by serial # |                                                                                        IT administrators can see and track HoloLens by device serial number in their MDM console. Refer to your MDM documentation for feature availability and instructions.                                                                                         |
-|                Set HoloLens device name through MDM (rename)                |                                                                                                IT administrators can see and rename HoloLens devices in their MDM console. Refer to your MDM documentation for feature availability and instructions.                                                                                                |
-
-### For international customers
-
-Feature | Details  
--- | ---
-Localized Chinese and Japanese builds | Use HoloLens with localized user interface for Simplified Chinese or Japanese, including localized Pinyin keyboard, dictation, and voice commands.  
-Speech Synthesis (TTS) | Speech synthesis feature now supports Chinese, Japanese, and English.
-
-[Learn how to install the Chinese and Japanese versions of HoloLens.](hololens1-install-localized.md)
-
-## Windows 10, version 1803 for Microsoft HoloLens
-
-> **Applies to:** Hololens (1st gen)
-
-Windows 10, version 1803, is the first feature update to Windows Holographic for Business since its release in Windows 10, version 1607. This update introduces the following changes:
-
- Previously, you could only verify that upgrade license for Commercial Suite had been applied to your HoloLens device by checking to see if VPN was an available option on the device. Now, **Settings** > **System** will display **Windows Holographic for Business** after the upgrade license is applied. [Learn how to unlock Windows Holographic for Business features](hololens1-upgrade-enterprise.md).
-
- You can view the operating system build number in device properties in the File Explorer app and in the [Windows Device Recovery Tool (WDRT)](https://support.microsoft.com/help/12379/windows-10-mobile-device-recovery-tool-faq).
-    
- Provisioning a HoloLens device is now easier with the new **Provision HoloLens devices** wizard in the Windows Configuration Designer tool. In the wizard, you can configure the setup experience and network connections, set developer mode, and obtain bulk Azure AD tokens. [Learn how to use the simple provisioning wizard for HoloLens](hololens-provisioning.md#provisioning-package-hololens-wizard).
-
-    ![Provisioning HoloLens devices](images/provision-hololens-devices.png)
-
- When you create a local account in a provisioning package, the password no longer expires every 42 days.
-
- You can [configure HoloLens as a single-app or multi-app kiosk](hololens-kiosk.md). Multi-app kiosk mode lets you set up a HoloLens to only run the apps that you specify, and prevents users from making changes.
-
- Media Transfer Protocol (MTP) is enabled so that you can connect the HoloLens device to a PC by USB and transfer files between HoloLens and the PC. You can also use the File Explorer app to move and delete files from within HoloLens.
-
- Previously, after you signed in to the device with an Azure Active Directory (Azure AD) account, you then had to **Add work access** in **Settings** to get access to corporate resources. Now, you sign in with an Azure AD account and enrollment happens automatically.
-
- Before you sign in, you can choose the network icon below the password field to choose a different Wi-Fi network to connect to. You can also connect to a guest network, such as at a hotel, conference center, or business.
-
- You can now easily [share HoloLens with multiple people](hololens-multiple-users.md) using Azure AD accounts.
-
- When setup or  sign-in fails, choose the new **Collect info** option to get diagnostic logs for troubleshooting.
-
- Individual users can sync their corporate email without enrolling their device in mobile device management (MDM). You can use the device with a Microsoft Account, download and install the Mail app, and add an email account directly.
-
- You can check the MDM sync status for a device in **Settings** > **Accounts** > **Access Work or School** > **Info**. In the **Device sync status** section, you can start a sync, see areas managed by MDM, and create and export an advanced diagnostics report.
--- a/devices/hololens/hololens2-language-support.md
+++ b/devices/hololens/hololens2-language-support.md
@ -7,7 +7,11 @@ author: Teresa-Motiv
 ms.author: v-tea
 ms.topic: article
 ms.localizationpriority: medium
-ms.date: 9/12/2019
+ms.custom: 
+- CI 115225
+- CSSTroubleshooting
+keywords: localize, language support, display language, keyboard language, IME, keyboard layout
+ms.date: 03/12/2020
 audience: ITPro
 ms.reviewer: jarrettr
 manager: jarrettr
@ -17,7 +21,7 @@ appliesto:

 # Supported languages for HoloLens 2

-HoloLens 2 supports the following languages, including voice commands and dictation features, keyboard layouts, and OCR recognition within apps.
+HoloLens 2 is localized into the following languages. The localization features include speech commands and dictation, keyboard layouts, and OCR recognition within apps.

 - Chinese Simplified (China)
 - English (Australia)
@ -31,43 +35,43 @@ HoloLens 2 supports the following languages, including voice commands and dictat
 - Japanese (Japan)
 - Spanish (Spain)

-HoloLens 2 is also available in the following languages. However, this support does not include speech commands or dictation features.
+HoloLens 2 also supports the following languages. However, this support does not include speech commands or dictation features.

 - Chinese Traditional (Taiwan and Hong Kong)
 - Dutch (Netherlands)
 - Korean (Korea)

-## Changing language or keyboard
-
-The setup process configures your HoloLens for a region and language. You can change this configuration by using the **Time & language** section of **Settings**.
-
-> [!NOTE]
-> Your speech and dictation language depends on the Windows display language.
-
-## To change the Windows display language
-
-1. Go to the **Start** menu, and then select **Settings** > **Time and language** > **Language**.
-2. Select **Windows display language**, and then select a language.  
-
-If the supported language you’re looking for is not in the menu, follow these steps: 
-
-1. Under **Preferred languages** select **Add a language**. 
-2. Search for and add the language.
-3. Select the **Windows display language** menu again and choose the language you added.
-
-The Windows display language affects the following settings for Windows and for apps that support localization:
+Some features of HoloLens 2 use the Windows display language. The Windows display language affects the following settings for Windows and for apps that support localization:

 - The user interface text language.
 - The speech language.
 - The default layout of the on-screen keyboard.

-## To change the keyboard layout
+## Change the language or keyboard layout

-To add or remove a keyboard layout, open the **Start** menu and then select **Settings** > **Time & language** > **Keyboard**.
+The setup process configures your HoloLens for a specific region and language. You can change this configuration by using the **Time & language** section of **Settings**.
+
+> [!NOTE]  
+> Your speech and dictation language depends on (and is the same as) the Windows display language.
+
+### To change the Windows display language
+
+1. Open the **Start** menu, and then select **Settings** > **Time and language** > **Language**.
+2. Select **Windows display language**, and then select a language.  
+
+If the supported language that you're looking for is not in the menu, follow these steps:  
+
+1. Under **Preferred languages**, select **Add a language**.
+2. Locater and add the language.
+3. Select the **Windows display language** menu again, and then select the language that you added in the previous step.
+
+### To change the keyboard layout
+
+To add or remove a keyboard layout, open the **Start** menu, and then select **Settings** > **Time & language** > **Keyboard**.

 If your HoloLens has more than one keyboard layout, use the **Layout** key to switch between them. The **Layout** key is in the lower right corner of the on-screen keyboard.

-> [!NOTE]
+> [!NOTE]  
 > The on-screen keyboard can use Input Method Editor (IME) to enter characters in languages such as Chinese. However, HoloLens does not support external Bluetooth keyboards that use IME.
-> 
-> While you use IME with the on-screen keyboard, you can continue to use a Bluetooth keyboard to type in English. To switch between keyboards, press ~.
+>  
+> While you use IME together with the on-screen keyboard, you can continue to use a Bluetooth keyboard to type in English. To switch between keyboards, press the tilde character button (**~**).
--- a/devices/hololens/index.md
+++ b/devices/hololens/index.md
@ -1,6 +1,6 @@
 ---
 title: Microsoft HoloLens
-description: Landing page Microsoft HoloLens.
+description: Landing page for Microsoft HoloLens.
 ms.prod: hololens
 ms.sitesec: library
 ms.assetid: 0947f5b3-8f0f-42f0-aa27-6d2cad51d040
@ -10,8 +10,11 @@ ms.topic: article
 ms.localizationpriority: medium
 ms.date: 10/14/2019
 audience: ITPro
+ms.custom: 
+- CI 111456
+- CSSTroubleshooting
 appliesto:
- HoloLens 1
+- HoloLens (1st gen)
 - HoloLens 2

 ---
--- a/devices/hololens/scep-whitepaper.md
+++ b/devices/hololens/scep-whitepaper.md
@ -11,20 +11,23 @@ ms.sitesec: library
 ms.topic: article
 audience: ITPro
 ms.localizationpriority: high
+ms.custom: 
+- CI 111456
+- CSSTroubleshooting
 appliesto:
 - HoloLens 1 (1st gen)
 - HoloLens 2
 ---

-# SCEP Whitepaper
+# SCEP whitepaper

 ## High Level

 ### How the SCEP Challenge PW is secured

-We work around the weakness of the SCEP protocol by generating custom challenges in Intune itself. The challenge string we create is signed/encrypted, and contains the information we’ve configured in Intune for certificate issuance into the challenge blob. This means the blob used as the challenge string contains the expected CSR information like the Subject Name, Subject Alternative Name, and other attributes.
+We work around the weakness of the SCEP protocol by generating custom challenges in Intune itself. The challenge string we create is signed/encrypted, and contains the information we've configured in Intune for certificate issuance into the challenge blob. This means the blob used as the challenge string contains the expected CSR information like the Subject Name, Subject Alternative Name, and other attributes.

-We then pass that to the device and then the device generates it’s CSR and passes it, and the blob to the SCEP URL it received in the MDM profile. On NDES servers running the Intune SCEP module we perform a custom challenge validation that validates the signature on the blob, decrypts the challenge blob itself, compare it to the CSR received, and then determine if we should issue the cert.  If any portion of this check fails then the certificate request is rejected.
+We then pass that to the device and then the device generates it's CSR and passes it, and the blob to the SCEP URL it received in the MDM profile. On NDES servers running the Intune SCEP module we perform a custom challenge validation that validates the signature on the blob, decrypts the challenge blob itself, compare it to the CSR received, and then determine if we should issue the cert.  If any portion of this check fails then the certificate request is rejected.

 ## Behind the scenes

@ -72,6 +75,6 @@ We then pass that to the device and then the device generates it’s CSR and pas

    1. 1st time configuration of the connector: Authentication to AAD during the initial connector setup.

-    1. Connector checks in with Intune, and will process and any cert revocation transactions (i.e, if the Intune tenant admin issues a remote wipe – full or partial,  also If a user unenrolls their device from Intune), reporting on issued certs, renewing the connectors’ SC_Online_Issuing  certificate from Intune.  Also note: the NDES Intune connector has shared PKCS cert functionality (if you decide to issue PKCS/PFX based certs) so the connector checks to Intune for PKCS cert requests even though there won’t be any requests to process.  We are splitting that functionality out, so this connector just handles SCEP, but no ETA yet.
+    1. Connector checks in with Intune, and will process and any cert revocation transactions (i.e, if the Intune tenant admin issues a remote wipe – full or partial,  also If a user unenrolls their device from Intune), reporting on issued certs, renewing the connectors' SC_Online_Issuing  certificate from Intune.  Also note: the NDES Intune connector has shared PKCS cert functionality (if you decide to issue PKCS/PFX based certs) so the connector checks to Intune for PKCS cert requests even though there won't be any requests to process.  We are splitting that functionality out, so this connector just handles SCEP, but no ETA yet.

 1. [Here](https://docs.microsoft.com/intune/intune-endpoints#microsoft-intune-certificate-connector) is a reference for Intune NDES connector network communications.
--- a/devices/surface-hub/device-reset-surface-hub.md
+++ b/devices/surface-hub/device-reset-surface-hub.md
@ -90,7 +90,7 @@ On rare occasions, a Surface Hub may encounter an error while cleaning up user a

 1. Use the power switch to turn the Surface Hub back on. The device starts and displays the Surface Hub Logo screen. When you see spinning dots under the Surface Hub Logo, use the power switch to turn the Surface Hub off again.  

-1. Repeat step 3 three times, or until the Surface Hub displays the “Preparing Automatic Repair” message. After it displays this message, the Surface Hub displays the Windows RE screen.
+1. Repeat step 3 three times, or until the Surface Hub displays the "Preparing Automatic Repair" message. After it displays this message, the Surface Hub displays the Windows RE screen.

 1. Select **Advanced Options**.

@ -115,6 +115,12 @@ On rare occasions, a Surface Hub may encounter an error while cleaning up user a
   ![downloading 97&](images/recover-progress.png)

   When the download finishes, the recovery process restores the Surface Hub according to the options that you selected.
+   
+
+## Contact Support
+
+If you have questions or need help, you can [create a support request](https://support.microsoft.com/supportforbusiness/productselection).
+

 ## Related topics

--- a/devices/surface-hub/index.md
+++ b/devices/surface-hub/index.md
@ -1,182 +0,0 @@
---
-title: Surface Hub
-author: greg-lindsay
-ms.author: greglin
-manager: laurawi
-layout: LandingPage
-ms.prod: surface-hub
-ms.tgt_pltfrm: na
-ms.devlang: na
-ms.topic: landing-page
-description: "Get started with Microsoft Surface Hub."
-ms.localizationpriority: High
---
-# Get started with Surface Hub
-
-Surface Hub 2S is an all-in-one digital interactive whiteboard, meetings platform, and collaborative computing device that brings the power of Windows 10 to team collaboration. Use the links below to learn how to plan, deploy, manage, and support your Surface Hub devices.
-
-<ul class="panelContent cardsF">
-    <li>
-        <div class="cardSize">
-            <div class="cardPadding">
-                <div class="card">
-                    <div class="cardImageOuter">
-                        <div class="cardImage">
-                            <img src="https://docs.microsoft.com/office/media/icons/get-started-blue.svg" alt="Get started icon" />
-                        </div>
-                    </div>
-                    <div class="cardText">
-                        <h3>Overview</h3>
-                        <p><a href="https://techcommunity.microsoft.com/t5/Surface-IT-Pro-Blog/Behind-the-design-Surface-Hub-2S/ba-p/464099" target="_blank">Behind the design: Surface Hub 2S</a></p>
-                        <p><a href="surface-hub-2s-whats-new.md">What's new in Surface Hub 2S</a></p>
-                        <p><a href="differences-between-surface-hub-and-windows-10-enterprise.md">Operating system essentials</a></p>
-                    </div>
-                </div>
-            </div>
-        </div>
-    </li>
-    <li>
-        <div class="cardSize">
-            <div class="cardPadding">
-                <div class="card">
-                    <div class="cardImageOuter">
-                        <div class="cardImage">
-                            <img src="https://docs.microsoft.com/office/media/icons/task-checklist-planning-blue.svg" alt="Plan icon" />
-                        </div>
-                    </div>
-                    <div class="cardText">
-                        <h3>Plan</h3>
-                        <p><a href="surface-hub-2s-site-readiness-guide.md">Surface Hub 2S Site Readiness Guide</a></p>
-                        <p><a href="surface-hub-2s-install-mount.md">Install and mount Surface Hub 2S</a></p>
-                        <p><a href="surface-hub-2s-custom-install.md">Customize Surface Hub 2S installation</a></p>
-                    </div>
-                </div>
-            </div>
-        </div>
-    </li>
-    <li>
-        <div class="cardSize">
-            <div class="cardPadding">
-                <div class="card">
-                    <div class="cardImageOuter">
-                        <div class="cardImage">
-                            <img src="https://docs.microsoft.com/office/media/icons/deploy-blue.svg" alt="Deploy icon" />
-                        </div>
-                    </div>
-                    <div class="cardText">
-                        <h3>Deploy</h3>
-                              <p><a href="surface-hub-2s-adoption-kit.md">Surface Hub 2S adoption and training</a></p>
-                              <p><a href="surface-hub-2s-deploy-checklist.md">Surface Hub 2S deployment checklist</a></p>
-                              <p><a href="surface-hub-2s-account.md">Create device account</a></p>
-                    </div>
-                </div>
-            </div>
-        </div>
-    </li>
-</ul>
-
-<ul class="panelContent cardsF">
-    <li>
-        <div class="cardSize">
-            <div class="cardPadding">
-                <div class="card">
-                    <div class="cardImageOuter">
-                        <div class="cardImage">
-                            <img src="https://docs.microsoft.com/office/media/icons/process-flow-blue.svg" alt="Manage icon" />
-                        </div>
-                    </div>
-                    <div class="cardText">
-                        <h3>Manage</h3>
-                        <p><a href="surface-hub-2s-manage-intune.md">Manage with Intune</a></p>
-                        <p><a href="local-management-surface-hub-settings.md">Manage local settings</a></p>
-                    </div>
-                </div>
-            </div>
-        </div>
-    </li>
-    <li>
-        <div class="cardSize">
-            <div class="cardPadding">
-                <div class="card">
-                    <div class="cardImageOuter">
-                        <div class="cardImage">
-                            <img src="https://docs.microsoft.com/office/media/icons/security-blue.svg" alt="Secure icon" />
-                        </div>
-                    </div>
-                    <div class="cardText">
-                        <h3>Secure</h3>
-                        <p><a href="surface-hub-2s-secure-with-uefi-semm.md">Secure with UEFI and SEMM</a></p>
-                        <p><a href="surface-hub-wifi-direct.md">Wi-Fi security considerations</a></p>
-                    </div>
-                </div>
-            </div>
-        </div>
-    </li>
-    <li>
-        <div class="cardSize">
-            <div class="cardPadding">
-                <div class="card">
-                    <div class="cardImageOuter">
-                        <div class="cardImage">
-                            <img src="https://docs.microsoft.com/office/media/icons/connector-blue.svg" alt="Support icon" />
-                        </div>
-                    </div>
-                    <div class="cardText">
-                        <h3>Troubleshoot</h3>
-                        <p><a href="https://support.microsoft.com/help/4493926" target="_blank">Service and warranty</a></p>
-                        <p><a href="surface-hub-2s-recover-reset.md">Recover & reset Surface Hub 2S</a></p>
-                        <p><a href="support-solutions-surface-hub.md">Surface Hub support solutions</a></p>
-                        <p><a href="https://support.office.com/article/Enable-Microsoft-Whiteboard-on-Surface-Hub-b5df4539-f735-42ff-b22a-0f5e21be7627" target="_blank">Enable Microsoft Whiteboard on Surface Hub</a></p>
-                    </div>
-                </div>
-            </div>
-        </div>
-    </li>
-</ul>
-
---
-
-<ul class="panelContent cardsW">
-    <li>
-        <div class="cardSize">
-            <div class="cardPadding">
-                <div class="card">
-                    <div class="cardText">
-                        <h3>Get ready for Surface Hub 2S</h3>
-                        <p><a href="https://www.microsoft.com/p/surface-hub-2S/8P62MW6BN9G4?activetab=pivot:overviewtab" target="_blank">Ordering Surface Hub 2S</p>
-                        <p><a href="surface-hub-2s-prepare-environment.md">Prepare your environment for Surface Hub 2S</p>
-                        <p><a href="surface-hub-2s-install-mount.md">Install & mount Surface Hub 2S</p>
-                    </div>
-                </div>
-            </div>
-        </div>
-    </li>
-    <li>
-        <div class="cardSize">
-            <div class="cardPadding">
-                <div class="card">
-                    <div class="cardText">
-                        <h3>Surface Hub 2S Videos</h3>
-                        <p><a href="surface-hub-2s-adoption-videos.md" target="_blank">Adoption and training videos</p>
-                        <p><a href="https://youtu.be/pbhNngw3a-Y" target="_blank">What is Surface Hub 2S?</p>
-                        <p><a href="https://www.youtube.com/watch?v=CH2seLS5Wb0" target="_blank">Surface Hub 2S with Teams</p>
-                        <p><a href="https://www.youtube.com/watch?v=I4N2lQX4WyI&list=PLXtHYVsvn_b__1Baibdu4elN4SoF3JTBZ&index=7" target="_blank">Surface Hub 2S with Microsoft 365</p>
-                    </div>
-                </div>
-            </div>
-        </div>
-    </li>
-    <li>
-        <div class="cardSize">
-            <div class="cardPadding">
-                <div class="card">
-                    <div class="cardText">
-                        <h3>Community</h3>
-                        <p><a href="https://techcommunity.microsoft.com/t5/Surface-Hub/bd-p/SurfaceHub" target="_blank">Join the Surface Hub Technical Community</p>
-                        <p><a href="https://techcommunity.microsoft.com/t5/Surface-Devices/ct-p/SurfaceDevices" target="_blank">Join the Surface Devices Technical Community</p>
-                    </div>
-                </div>
-            </div>
-        </div>
-    </li>
-</ul>
--- a/devices/surface-hub/index.yml
+++ b/devices/surface-hub/index.yml
@ -0,0 +1,127 @@
+### YamlMime:Hub
+
+title: Surface Hub documentation # < 60 chars
+summary: Surface Hub 2S is an all-in-one digital interactive whiteboard, meetings platform, and collaborative computing device. # < 160 chars
+# brand: aspnet | azure | dotnet | dynamics | m365 | ms-graph | office | power-bi | power-platform | sql | sql-server | vs | visual-studio | windows | xamarin
+brand: windows
+
+metadata:
+  title: Surface Hub documentation # Required; page title displayed in search results. Include the brand. < 60 chars.
+  description: Get started with Microsoft Surface Hub. # Required; article description that is displayed in search results. < 160 chars.
+  services: product-insights
+  ms.service: product-insights #Required; service per approved list. service slug assigned to your service by ACOM.
+  ms.topic: hub-page # Required
+  ms.prod: surface-hub
+  ms.technology: windows
+  audience: ITPro
+  ms.localizationpriority: medium
+  author: greg-lindsay #Required; your GitHub user alias, with correct capitalization.
+  ms.author: greglin #Required; microsoft alias of author; optional team alias.
+  manager: laurawi
+
+# highlightedContent section (optional)
+# Maximum of 8 items
+highlightedContent:
+# itemType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | sample | tutorial | video | whats-new
+  items:
+    # Card
+    - title: What is Surface Hub 2S?
+      itemType: overview
+      url: https://techcommunity.microsoft.com/t5/Surface-IT-Pro-Blog/Behind-the-design-Surface-Hub-2S/ba-p/464099
+    # Card
+    - title: What's new in Surface Hub 2S?
+      itemType: whats-new
+      url: surface-hub-2s-whats-new.md
+    # Card
+    - title: Operating system essentials
+      itemType: learn
+      url: differences-between-surface-hub-and-windows-10-enterprise.md
+    # Card
+    - title: Surface Hub 2S Site Readiness Guide
+      itemType: learn
+      url: surface-hub-2s-site-readiness-guide.md
+    # Card
+    - title: Install and mount Surface Hub 2S
+      itemType: how-to-guide
+      url: surface-hub-2s-install-mount.md
+    # Card
+    - title: Customize Surface Hub 2S installation
+      itemType: how-to-guide
+      url: surface-hub-2s-custom-install.md
+
+# productDirectory section (optional)
+productDirectory:
+  title: Deploy, manage, and support your Surface Hub devices # < 60 chars (optional)
+  summary: Find related links to deploy, manage and support your Surface Hub devices. # < 160 chars (optional)
+  items:
+    # Card
+    - title: Deploy
+      # imageSrc should be square in ratio with no whitespace
+      imageSrc: https://docs.microsoft.com/office/media/icons/deploy-blue.svg
+      links:
+        - url: surface-hub-2s-adoption-kit.md
+          text: Surface Hub 2S adoption and training
+        - url: surface-hub-2s-deploy-checklist.md
+          text: Surface Hub 2S deployment checklist
+        - url: surface-hub-2s-account.md
+          text: Create device account
+    # Card
+    - title: Manage
+      imageSrc: https://docs.microsoft.com/office/media/icons/process-flow-blue.svg
+      links:
+        - url: surface-hub-2s-manage-intune.md
+          text: Manage with Intune
+        - url: local-management-surface-hub-settings.md
+          text: Manage local settings
+    # Card
+    - title: Secure
+      imageSrc: https://docs.microsoft.com/office/media/icons/security-blue.svg
+      links:
+        - url: surface-hub-2s-secure-with-uefi-semm.md
+          text: Secure with UEFI and SEMM
+        - url: surface-hub-wifi-direct.md
+          text: Wi-Fi security considerations
+    # Card
+    - title:  Troubleshoot
+      imageSrc: https://docs.microsoft.com/office/media/icons/connector-blue.svg
+      links:
+        - url: https://support.microsoft.com/help/4493926
+          text: Service and warranty
+        - url: surface-hub-2s-recover-reset.md
+          text: Recover & reset Surface Hub 2S
+        - url: support-solutions-surface-hub.md
+          text: Surface Hub support solutions
+        - url: https://support.office.com/article/Enable-Microsoft-Whiteboard-on-Surface-Hub-b5df4539-f735-42ff-b22a-0f5e21be7627
+          text: Enable Microsoft Whiteboard on Surface Hub
+
+# additionalContent section (optional)
+# Card with links style
+additionalContent:
+  # Supports up to 3 sections
+  sections:
+    - title: Other content # < 60 chars (optional)
+      summary: Find related links for videos, community and support. # < 160 chars (optional)
+      items:
+        # Card
+        - title: Get ready for Surface Hub 2S
+          links:
+            - text: Ordering Surface Hub 2S
+              url: https://www.microsoft.com/p/surface-hub-2S/8P62MW6BN9G4?activetab=pivot:overviewtab
+            - text: Prepare your environment for Surface Hub 2S
+              url: surface-hub-2s-prepare-environment.md
+        # Card
+        - title: Surface Hub 2S Videos
+          links:
+            - text: Adoption and training videos
+              url: surface-hub-2s-adoption-videos.md
+            - text: Surface Hub 2S with Teams
+              url: https://www.youtube.com/watch?v=CH2seLS5Wb0
+            - text: Surface Hub 2S with Microsoft 365
+              url: https://www.youtube.com/watch?v=I4N2lQX4WyI&list=PLXtHYVsvn_b__1Baibdu4elN4SoF3JTBZ&index=7
+        # Card
+        - title: Community
+          links:
+            - text: Join the Surface Hub Technical Community
+              url: https://techcommunity.microsoft.com/t5/Surface-Hub/bd-p/SurfaceHub
+            - text: Join the Surface Devices Technical Community
+              url: https://techcommunity.microsoft.com/t5/Surface-Devices/ct-p/SurfaceDevices
--- a/devices/surface-hub/miracast-troubleshooting.md
+++ b/devices/surface-hub/miracast-troubleshooting.md
@ -21,13 +21,13 @@ In traditional Miracast, the projecting device will connect the access point set
 - The first step is an initial connection using 2.4GHz. 
 - After that initial handshake, the projecting device sends traffic to the monitor using the wireless channel settings on the monitor. If Surface Hub is connected to a Wi-Fi network, the access point, it will use the same channel as the connected network, otherwise it will use the Miracast channel from Settings.

-There are generally two types of issues with Miracast to Surface Hub: [connection](#connect-issues) and [performance](#performance-issues). In either case, it is a good idea to get a general picture of wireless network activity in the Surface Hub’s location. Running a network scanning tool will show you the available networks and channel usage in the environment.
+There are generally two types of issues with Miracast to Surface Hub: [connection](#connect-issues) and [performance](#performance-issues). In either case, it is a good idea to get a general picture of wireless network activity in the Surface Hub's location. Running a network scanning tool will show you the available networks and channel usage in the environment.

 ## Connect issues

 Ensure both Wi-Fi and Miracast are both enabled in Settings on Surface Hub. 

-If you ran a network scan, you should see Surface Hub Miracast listed as an access point. If Surface Hub’s Miracast network shows up on the scan, but you cannot not see it as an available device, you can try to adjust the Miracast channel used by Surface Hub. 
+If you ran a network scan, you should see Surface Hub Miracast listed as an access point. If Surface Hub's Miracast network shows up on the scan, but you cannot not see it as an available device, you can try to adjust the Miracast channel used by Surface Hub. 

 When Surface Hub is connected to a Wi-Fi network it will use the same channel settings as the Wi-Fi access point for its Miracast access point. For troubleshooting purposes, disconnect Surface Hub from any Wi-Fi networks (but keep Wi-Fi enabled), so you can control the channel used for Miracast. You can manually select the Miracast channel in Settings. You will need to restart Surface Hub after each change. Generally speaking, you will want to use channels that do not show heavy utilization from the network scan.

@ -42,7 +42,7 @@ It is also a good idea to ensure the latest drivers and updates are installed on
 Next, ensure Miracast is supported on the device. 

 1. Press Windows Key + R and type `dxdiag`. 
-2. Click “Save all information”. 
+2. Click "Save all information". 
 3. Open the saved dxdiag.txt and find **Miracast**. It should say **Available, with HDCP**. 
    
 ### Check firewall
@ -63,7 +63,7 @@ On domain-joined devices, Group Policy can also block Miracast.

 ### Check event logs

-The last place to check is in the Event logs. Miracast events will be logged to **Wlanautoconfig**. This is true on both Surface Hub and the projecting device. If you export Surface Hub logs, you can view Surface Hub’s Wlanautoconfig in the **WindowsEventLog** folder. Errors in the event log can provide some additional details on where the connection fails.
+The last place to check is in the Event logs. Miracast events will be logged to **Wlanautoconfig**. This is true on both Surface Hub and the projecting device. If you export Surface Hub logs, you can view Surface Hub's Wlanautoconfig in the **WindowsEventLog** folder. Errors in the event log can provide some additional details on where the connection fails.

 ## Performance issues

@ -75,7 +75,10 @@ Channel switching is caused when the Wi-Fi adapter needs to send traffic to mult

 If Surface Hub and the projecting device are both connected to Wi-Fi but using different access points with different channels, this will force Surface Hub and the projecting device to channel switch while Miracast is connected. This will result in both poor wireless project and poor network performance over Wi-Fi. The channel switching will affect the performance of all wireless traffic, not just wireless projection. 

-Channel switching will also occur if the projecting device is connected to an Wi-Fi network using a different channel than the channel that Surface Hub uses for Miracast. So, a best practice is to set Surface Hub’s Miracast channel to the same channel as the most commonly used access point. 
+Channel switching will also occur if the projecting device is connected to an Wi-Fi network using a different channel than the channel that Surface Hub uses for Miracast. So, a best practice is to set Surface Hub's Miracast channel to the same channel as the most commonly used access point. 

 If there are multiple Wi-Fi networks or access points in the environment, some channel switching is unavoidable. This is best addressed by ensuring all Wi-Fi drivers are up to date.

+## Contact Support
+
+If you have questions or need help, you can [create a support request](https://support.microsoft.com/supportforbusiness/productselection).
--- a/devices/surface-hub/surface-hub-2s-manage-intune.md
+++ b/devices/surface-hub/surface-hub-2s-manage-intune.md
@ -50,22 +50,26 @@ To ensure optimal video and audio quality on Surface Hub 2S, add the following Q

 |**Name**|**Description**|**OMA-URI**|**Type**|**Value**|
 |:------ |:------------- |:--------- |:------ |:------- |
-|**Audio Ports**| Audio Port range | ./Device/Vendor/MSFT/NetworkQoSPolicy/HubAudio/DestinationPortMatchCondition | String  | 3478-3479 |
-|**Audio DSCP**| Audio ports marking | ./Device/Vendor/MSFT/NetworkQoSPolicy/HubAudio/DSCPAction | Integer | 46 |
-|**Video Ports**| Video Port range | ./Device/Vendor/MSFT/NetworkQoSPolicy/HubVideo/DestinationPortMatchCondition | String  | 3480 |
-|**Video DSCP**| Video ports marking | ./Device/Vendor/MSFT/NetworkQoSPolicy/HubVideo/DSCPAction | Integer | 34 |
+|**Audio Ports**| Audio Port range | ./Device/Vendor/MSFT/NetworkQoSPolicy/TeamsAudio/DestinationPortMatchCondition | String  | 3478-3479 |
+|**Audio DSCP**| Audio ports marking | ./Device/Vendor/MSFT/NetworkQoSPolicy/TeamsAudio/DSCPAction | Integer | 46 |
+|**Video Port**| Video Port range | ./Device/Vendor/MSFT/NetworkQoSPolicy/TeamsVideo/DestinationPortMatchCondition | String  | 3480 |
+|**Video DSCP**| Video ports marking | ./Device/Vendor/MSFT/NetworkQoSPolicy/TeamsVideo/DSCPAction | Integer | 34 |
+|**P2P Audio Ports**| Audio Port range | ./Device/Vendor/MSFT/NetworkQoSPolicy/TeamsP2PAudio/DestinationPortMatchCondition | String  | 50000-50019 |
+|**P2P Audio DSCP**| Audio ports marking | ./Device/Vendor/MSFT/NetworkQoSPolicy/TeamsP2PAudio/DSCPAction | Integer | 46 |
+|**P2P Video Ports**| Video Port range | ./Device/Vendor/MSFT/NetworkQoSPolicy/TeamsP2PVideo/DestinationPortMatchCondition | String  | 50020-50039 |
+|**P2P Video DSCP**| Video ports marking | ./Device/Vendor/MSFT/NetworkQoSPolicy/TeamsP2PVideo/DSCPAction | Integer | 34 |


 ### Skype for Business QoS settings

 | Name               | Description         | OMA-URI                                                                  | Type    | Value                          |
 | ------------------ | ------------------- | ------------------------------------------------------------------------ | ------- | ------------------------------ |
-| Audio Ports        | Audio Port range    | ./Device/Vendor/MSFT/NetworkQoSPolicy/HubAudio/SourcePortMatchCondition  | String  | 50000-50019                    |
-| Audio DSCP         | Audio ports marking | ./Device/Vendor/MSFT/NetworkQoSPolicy/HubAudio/DSCPAction                | Integer | 46                             |
-| Audio Media Source | Skype App name      | ./Device/Vendor/MSFT/NetworkQoSPolicy/HubAudio/AppPathNameMatchCondition | String  | Microsoft.PPISkype.Windows.exe |
-| Video Ports        | Video Port range    | ./Device/Vendor/MSFT/NetworkQoSPolicy/HubVideo/SourcePortMatchCondition  | String  | 50020-50039                    |
-| Video DSCP         | Video ports marking | ./Device/Vendor/MSFT/NetworkQoSPolicy/HubVideo/DSCPAction                | Integer | 34                             |
-| Video Media Source | Skype App name      | ./Device/Vendor/MSFT/NetworkQoSPolicy/HubVideo/AppPathNameMatchCondition | String  | Microsoft.PPISkype.Windows.exe |
+| Audio Ports        | Audio Port range    | ./Device/Vendor/MSFT/NetworkQoSPolicy/SfBAudio/SourcePortMatchCondition  | String  | 50000-50019                    |
+| Audio DSCP         | Audio ports marking | ./Device/Vendor/MSFT/NetworkQoSPolicy/SfBAudio/DSCPAction                | Integer | 46                             |
+| Audio Media Source | Skype App name      | ./Device/Vendor/MSFT/NetworkQoSPolicy/SfBAudio/AppPathNameMatchCondition | String  | Microsoft.PPISkype.Windows.exe |
+| Video Ports        | Video Port range    | ./Device/Vendor/MSFT/NetworkQoSPolicy/SfBVideo/SourcePortMatchCondition  | String  | 50020-50039                    |
+| Video DSCP         | Video ports marking | ./Device/Vendor/MSFT/NetworkQoSPolicy/SfBVideo/DSCPAction                | Integer | 34                             |
+| Video Media Source | Skype App name      | ./Device/Vendor/MSFT/NetworkQoSPolicy/SfBVideo/AppPathNameMatchCondition | String  | Microsoft.PPISkype.Windows.exe |

 > [!NOTE]
 > Both tables show default port ranges. Administrators may change the port ranges in the Skype for Business and Teams control panel.
--- a/devices/surface-hub/surface-hub-2s-recover-reset.md
+++ b/devices/surface-hub/surface-hub-2s-recover-reset.md
@ -69,3 +69,7 @@ At the end of a session, Surface Hub 2S may occasionally encounter an error duri

 > [!NOTE]
 > To enter recovery mode, unplug the power cord and plug it in again three times.
+
+## Contact Support
+
+If you have questions or need help, you can [create a support request](https://support.microsoft.com/supportforbusiness/productselection).
--- a/devices/surface-hub/surface-hub-update-history.md
+++ b/devices/surface-hub/surface-hub-update-history.md
@ -24,6 +24,21 @@ Please refer to the “[Surface Hub Important Information](https://support.micro

 ## Windows 10 Team Creators Update 1703

+<details>
+<summary>February 28, 2020—update for Surface Hub 2S</summary>
+
+This update is specific to the Surface Hub 2S and provides the driver and firmware updates outlined below:
+
+* Surface Integration driver - 13.46.139.0 
+  * Improves display brightness scenarios.
+* Intel(R) Management Engine Interface driver - 1914.12.0.1256
+  * Improves system stability.
+* Surface SMC Firmware update - 1.161.139.0
+  * Improves pen battery performance.
+* Surface UEFI update - 694.2938.768.0
+  * Improves system stability.
+</details>
+
 <details>
 <summary>February 11, 2020—update for Team edition based on KB4537765* (OS Build 15063.2284)</summary>

--- a/devices/surface-hub/troubleshoot-surface-hub.md
+++ b/devices/surface-hub/troubleshoot-surface-hub.md
@ -456,15 +456,15 @@ This section lists status codes, mapping, user messages, and actions an admin ca
 <tr class="even">
 <td align="left"><p>0x80072EFD</p></td>
 <td align="left"><p>WININET_E_CANNOT_CONNECT</p></td>
-<td align="left"><p>Can’t connect to the server right now. Wait a while and try again, or check the account settings.</p></td>
+<td align="left"><p>Can't connect to the server right now. Wait a while and try again, or check the account settings.</p></td>
 <td align="left"><p>Verify that the server name is correct and reachable. Verify that the device is connected to the network.</p></td>
 </tr>
 <tr class="odd">
 <td align="left"><p>0x86000C29</p></td>
-<td align="left"><p>E_NEXUS_STATUS_DEVICE_NOTPROVISIONED (policies don’t match)</p></td>
+<td align="left"><p>E_NEXUS_STATUS_DEVICE_NOTPROVISIONED (policies don't match)</p></td>
 <td align="left"><p>The account is configured with policies not compatible with Surface Hub.</p></td>
 <td align="left"><p>Disable the <strong>PasswordEnabled</strong> policy for this account.</p>
-<p>We have a bug were we may surface policy errors if the account doesn’t receive any server notifications within the policy refresh interval.</p></td>
+<p>We have a bug were we may surface policy errors if the account doesn't receive any server notifications within the policy refresh interval.</p></td>
 </tr>
 <tr class="even">
 <td align="left"><p>0x86000C4C</p></td>
@ -475,7 +475,7 @@ This section lists status codes, mapping, user messages, and actions an admin ca
 <tr class="odd">
 <td align="left"><p>0x86000C0A</p></td>
 <td align="left"><p>E_NEXUS_STATUS_SERVERERROR_RETRYLATER</p></td>
-<td align="left"><p>Can’t connect to the server right now.</p></td>
+<td align="left"><p>Can't connect to the server right now.</p></td>
 <td align="left"><p>Wait until the server comes back online. If the issue persists, re-provision the account.</p></td>
 </tr>
 <tr class="even">
@ -487,7 +487,7 @@ This section lists status codes, mapping, user messages, and actions an admin ca
 <tr class="odd">
 <td align="left"><p>0x8505000D</p></td>
 <td align="left"><p>E_AIRSYNC_RESET_RETRY</p></td>
-<td align="left"><p>Can’t connect to the server right now. Wait a while or check the account’s settings.</p></td>
+<td align="left"><p>Can't connect to the server right now. Wait a while or check the account's settings.</p></td>
 <td align="left"><p>This is normally a transient error but if the issue persists check the number of devices associated with the account and delete some of them if the number is large.</p></td>
 </tr>
 <tr class="even">
@ -499,13 +499,13 @@ This section lists status codes, mapping, user messages, and actions an admin ca
 <tr class="odd">
 <td align="left"><p>0x85010004</p></td>
 <td align="left"><p>E_HTTP_FORBIDDEN</p></td>
-<td align="left"><p>Can’t connect to the server right now. Wait a while and try again, or check the account’s settings.</p></td>
+<td align="left"><p>Can't connect to the server right now. Wait a while and try again, or check the account's settings.</p></td>
 <td align="left"><p>Verify the server name to make sure it is correct. If the account is using cert based authentication make sure the certificate is still valid and update it if not.</p></td>
 </tr>
 <tr class="even">
 <td align="left"><p>0x85030028</p></td>
 <td align="left"><p>E_ACTIVESYNC_PASSWORD_OR_GETCERT</p></td>
-<td align="left"><p>The account’s password or client certificate are missing or invalid.</p></td>
+<td align="left"><p>The account's password or client certificate are missing or invalid.</p></td>
 <td align="left"><p>Update the password and/or deploy the client certificate.</p></td>
 </tr>
 <tr class="odd">
@ -523,7 +523,7 @@ This section lists status codes, mapping, user messages, and actions an admin ca
 <tr class="odd">
 <td align="left"><p>0x80072EE2</p></td>
 <td align="left"><p>WININET_E_TIMEOUT</p></td>
-<td align="left"><p>The network doesn’t support the minimum idle timeout required to receive server notification, or the server is offline.</p></td>
+<td align="left"><p>The network doesn't support the minimum idle timeout required to receive server notification, or the server is offline.</p></td>
 <td align="left"><p>Verify that the server is running. Verify the NAT settings.</p></td>
 </tr>
 <tr class="even">
@ -535,13 +535,13 @@ This section lists status codes, mapping, user messages, and actions an admin ca
 <tr class="odd">
 <td align="left"><p>0x85010017</p></td>
 <td align="left"><p>E_HTTP_SERVICE_UNAVAIL</p></td>
-<td align="left"><p>Can’t connect to the server right now. Wait a while or check the account’s settings.</p></td>
+<td align="left"><p>Can't connect to the server right now. Wait a while or check the account's settings.</p></td>
 <td align="left"><p>Verify the server name to make sure it is correct. Wait until the server comes back online. If the issue persists, re-provision the account.</p></td>
 </tr>
 <tr class="even">
 <td align="left"><p>0x86000C0D</p></td>
 <td align="left"><p>E_NEXUS_STATUS_MAILBOX_SERVEROFFLINE</p></td>
-<td align="left"><p>Can’t connect to the server right now. Wait a while or check the account’s settings.</p></td>
+<td align="left"><p>Can't connect to the server right now. Wait a while or check the account's settings.</p></td>
 <td align="left"><p>Verify the server name to make sure it is correct. Wait until the server comes back online. If the issue persists, re-provision the account.</p></td>
 </tr>
 <tr class="odd">
@ -555,7 +555,7 @@ This section lists status codes, mapping, user messages, and actions an admin ca
 <td align="left"><p>E_NEXUS_STATUS_INVALID_POLICYKEY</p></td>
 <td align="left"><p>The account is configured with policies not compatible with Surface Hub.</p></td>
 <td align="left"><p>Disable the PasswordEnabled policy for this account.</p>
-<p>We have a bug were we may surface policy errors if the account doesn’t receive any server notifications within the policy refresh interval.</p></td>
+<p>We have a bug were we may surface policy errors if the account doesn't receive any server notifications within the policy refresh interval.</p></td>
 </tr>
 <tr class="odd">
 <td align="left"><p>0x85010005</p></td>
@ -566,7 +566,7 @@ This section lists status codes, mapping, user messages, and actions an admin ca
 <tr class="even">
 <td align="left"><p>0x85010014</p></td>
 <td align="left"><p>E_HTTP_SERVER_ERROR</p></td>
-<td align="left"><p>Can’t connect to the server.</p></td>
+<td align="left"><p>Can't connect to the server.</p></td>
 <td align="left"><p>Verify the server name to make sure it is correct. Trigger a sync and, if the issue persists, re-provision the account.</p></td>
 </tr>
 <tr class="odd">
@ -602,7 +602,10 @@ This section lists status codes, mapping, user messages, and actions an admin ca
 </tbody>
 </table>

- 
+## Contact Support
+
+If you have questions or need help, you can [create a support request](https://support.microsoft.com/supportforbusiness/productselection).
+

  
 ## Related content
--- a/devices/surface/TOC.md
+++ b/devices/surface/TOC.md
@ -1,6 +1,6 @@
 # [Surface](index.yml)

-## [Get started](get-started.md)
+## [Surface devices documentation](get-started.yml)

 ## Overview

--- a/devices/surface/get-started.md
+++ b/devices/surface/get-started.md
@ -1,169 +0,0 @@
---
-title: Get started with Surface devices
-author: greg-lindsay
-ms.author: greglin
-manager: laurawi
-layout: LandingPage
-ms.assetid: 
-ms.audience: itpro
-ms.tgt_pltfrm: na
-ms.devlang: na
-ms.topic: landing-page
-description: "Get started with Microsoft Surface devices"
-ms.localizationpriority: High
---
-# Get started with Surface devices
-
-Harness the power of Surface, Windows, and Office connected together through the cloud. Find tools, step-by-step guides, and other resources to help you plan, deploy, and manage Surface for Business devices in your organization.
-
-<ul class="panelContent cardsF">
-    <li>
-        <div class="cardSize">
-            <div class="cardPadding">
-                <div class="card">
-                    <div class="cardImageOuter">
-                        <div class="cardImage">
-                            <img src="https://docs.microsoft.com/office/media/icons/task-checklist-planning-blue.svg" alt="Plan" />
-                        </div>
-                    </div>
-                    <div class="cardText">
-                        <h3>Plan</h3>
-                         <p><a href="considerations-for-surface-and-system-center-configuration-manager.md">Surface and Endpoint Configuration Manager considerations</a></p>
-                         <p><a href="wake-on-lan-for-surface-devices.md">Wake On LAN for Surface devices</a></p>
-                    </div>
-                </div>
-            </div>
-        </div>
-    </li>
-    <li>
-        <div class="cardSize">
-            <div class="cardPadding">
-                <div class="card">
-                    <div class="cardImageOuter">
-                        <div class="cardImage">
-                            <img src="https://docs.microsoft.com/office/media/icons/deploy-blue.svg" alt="Deploy" />
-                        </div>
-                    </div>
-                    <div class="cardText">
-                        <h3>Deploy</h3>
-                         <p><a href="manage-surface-driver-and-firmware-updates.md">Manage and deploy Surface driver and firmware updates</a></p>
-                        <p><a href="windows-autopilot-and-surface-devices.md">Autopilot and Surface devices</a></p>
-                        <p><a href="surface-pro-arm-app-management.md">Deploying, managing, and servicing Surface Pro X</a></p>
-                      
-                    </div>
-                </div>
-            </div>
-        </div>
-    </li>
-    <li>
-        <div class="cardSize">
-            <div class="cardPadding">
-                <div class="card">
-                    <div class="cardImageOuter">
-                        <div class="cardImage">
-                            <img src="https://docs.microsoft.com/office/media/icons/process-flow-blue.svg" alt="Manage" />
-                        </div>
-                    </div>
-                    <div class="cardText">
-                        <h3>Manage</h3>
-                        <p><a href="surface-wireless-connect.md">Optimize Wi-Fi connectivity for Surface devices</a></p>
-                        <p><a href="maintain-optimal-power-settings-on-Surface-devices.md">Best practice power settings for Surface devices</a></p>
-                        <p><a href="battery-limit.md">Manage battery limit with UEFI</a></p>
-                    </div>
-                </div>
-            </div>
-        </div>
-    </li>
-</ul>
-<ul class="panelContent cardsF">
-    <li>
-        <div class="cardSize">
-            <div class="cardPadding">
-                <div class="card">
-                    <div class="cardImageOuter">
-                        <div class="cardImage">
-                            <img src="https://docs.microsoft.com/office/media/icons/security-blue.svg" alt="Secure" />
-                        </div>
-                    </div>
-                    <div class="cardText">
-                        <h3>Secure</h3>
-                          <p><a href="surface-manage-dfci-guide.md">Intune management of Surface UEFI settings</a></p>
-                          <p><a href="surface-enterprise-management-mode.md">Surface Enterprise Management Mode (SEMM)</a></p>                     
-                        <p><a href="microsoft-surface-data-eraser.md">Surface Data Eraser tool</a></p>
-                    </div>
-                </div>
-            </div>
-        </div>
-    </li>
-    <li>
-        <div class="cardSize">
-            <div class="cardPadding">
-                <div class="card">
-                    <div class="cardImageOuter">
-                        <div class="cardImage">
-                            <img src="https://docs.microsoft.com/office/media/icons/connector-blue.svg" alt="Support" />
-                        </div>
-                    </div>
-                    <div class="cardText">
-                        <h3>Support</h3>
-                         <p><a href="https://support.microsoft.com/help/4483194/maximize-surface-battery-life">Maximize your Surface battery life</a></p>
-                         <p><a href="https://support.microsoft.com/help/4023468/surface-troubleshoot-surface-dock-and-docking-stations">Troubleshoot Surface Dock and docking stations</a></p>
-                        <p><a href="support-solutions-surface.md">Top support solutions</a></p>
-                    </div>
-                </div>
-            </div>
-        </div>
-    </li>
-</ul>
-
---
-
-<ul class="panelContent cardsW">
-    <li>
-        <div class="cardSize">
-            <div class="cardPadding">
-                <div class="card">
-                    <div class="cardText">
-                        <h3>Tech specs</h3>
-                           <P><a href="https://www.microsoft.com/surface/business/surface-pro-7" target="_blank">Surface Pro 7 for Business</a></P>
-                            <P><a href="https://www.microsoft.com/surface/business/surface-pro-x" target="_blank">Surface Pro X for Business</a></p>
-                            <P><a href="https://www.microsoft.com/surface/business/surface-laptop-3" target="_blank">Surface Laptop 3 for Business</a></p>
-                              <P><a href="https://www.microsoft.com/surface/business/surface-book-2" target="_blank">Surface Book 2 for Business</a></p>
-                              <P><a href="https://www.microsoft.com/surface/business/surface-studio-2" target="_blank">Surface Studio 2 for Business</a></p>
-                              <P><a href="https://www.microsoft.com/surface/business/surface-go" target="_blank">Surface Go</a></p>
-                    </div>
-                </div>
-            </div>
-        </div>
-    </li>
-    <li>
-        <div class="cardSize">
-            <div class="cardPadding">
-                <div class="card">
-                    <div class="cardText">
-                        <h3>Discover Surface tools</h3>
-                         <P><a href="surface-dock-firmware-update.md">Surface Dock Firmware Update</a></p>
-                         <P><a href="surface-diagnostic-toolkit-for-business-intro.md">Surface Diagnostic Toolkit for Business</a></p>
-                         <P><a href="surface-enterprise-management-mode.md">SEMM and UEFI</a></p>
-                         <P><a href="microsoft-surface-brightness-control.md">Surface Brightness Control</a></p>
-                         <P><a href="battery-limit.md">Battery Limit setting</a></p>
-                    </div>
-                </div>
-            </div>
-        </div>
-    </li>
-    <li>
-        <div class="cardSize">
-            <div class="cardPadding">
-                <div class="card">
-                    <div class="cardText">
-                        <h3>Community</h3>
-                        <p><a href="https://techcommunity.microsoft.com/t5/Surface-IT-Pro-Blog/bg-p/SurfaceITPro" target="_blank">Surface IT Pro blog</a></p>
-                        <p><a href="https://techcommunity.microsoft.com/t5/Surface-Devices/ct-p/SurfaceDevices" target="_blank">Surface Devices Tech Community</a></p>
-                        <p><a href="https://www.youtube.com/watch?v=Uk2kJ5FUZxY&list=PLXtHYVsvn_b__1Baibdu4elN4SoF3JTBZ" target="_blank">Microsoft Mechanics Surface videos</a></p>
-                    </div>
-                </div>
-            </div>
-        </div>
-    </li>
-</ul>
--- a/devices/surface/get-started.yml
+++ b/devices/surface/get-started.yml
@ -0,0 +1,122 @@
+### YamlMime:Landing
+
+title: Surface devices documentation # < 60 chars
+summary: Harness the power of Surface, Windows, and Office connected together through the cloud. # < 160 chars
+
+metadata:
+  title: Surface devices documentation # Required; page title displayed in search results. Include the brand. < 60 chars.
+  description: Get started with Microsoft Surface devices # Required; article description that is displayed in search results. < 160 chars.
+  ms.service: product-insights #Required; service per approved list. service slug assigned to your service by ACOM.
+  ms.topic: landing-page # Required
+  manager: laurawi
+  author: greg-lindsay #Required; your GitHub user alias, with correct capitalization.
+  ms.author: greglin #Required; microsoft alias of author; optional team alias.
+  audience: itpro
+  ms.localizationpriority: High
+
+# linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | sample | tutorial | video | whats-new
+
+landingContent:
+# Cards and links should be based on top customer tasks or top subjects
+# Start card title with a verb
+  # Card (optional)
+  - title: Surface devices
+    linkLists:
+      - linkListType: overview
+        links:
+          - text: Surface Pro 7 for Business
+            url: https://www.microsoft.com/surface/business/surface-pro-7
+          - text: Surface Pro X for Business
+            url: https://www.microsoft.com/surface/business/surface-pro-x
+          - text: Surface Laptop 3 for Business
+            url: https://www.microsoft.com/surface/business/surface-laptop-3
+          - text: Surface Book 2 for Business
+            url: https://www.microsoft.com/surface/business/surface-book-2
+          - text: Surface Studio 2 for Business
+            url: https://www.microsoft.com/surface/business/surface-studio-2
+          - text: Surface Go
+            url: https://www.microsoft.com/surface/business/surface-go
+      - linkListType: video
+        links:
+          - text: Microsoft Mechanics Surface videos
+            url: https://www.youtube.com/watch?v=Uk2kJ5FUZxY&list=PLXtHYVsvn_b__1Baibdu4elN4SoF3JTBZ
+
+  # Card (optional)
+  - title: Get started
+    linkLists:
+      - linkListType: get-started
+        links:
+          - text: Surface and Endpoint Configuration Manager considerations
+            url: considerations-for-surface-and-system-center-configuration-manager.md
+          - text: Wake On LAN for Surface devices
+            url: wake-on-lan-for-surface-devices.md
+
+  # Card
+  - title: Deploy Surface devices
+    linkLists:
+      - linkListType: deploy
+        links:
+          - text: Manage and deploy Surface driver and firmware updates
+            url: manage-surface-driver-and-firmware-updates.md
+          - text: Autopilot and Surface devices
+            url: windows-autopilot-and-surface-devices.md
+          - text: Deploying, managing, and servicing Surface Pro X
+            url: surface-pro-arm-app-management.md
+
+  # Card
+  - title: Manage Surface devices
+    linkLists:
+      - linkListType: how-to-guide
+        links:
+          - text: Optimize Wi-Fi connectivity for Surface devices
+            url: surface-wireless-connect.md
+          - text: Best practice power settings for Surface devices
+            url: maintain-optimal-power-settings-on-Surface-devices.md
+          - text: Manage battery limit with UEFI
+            url: battery-limit.md
+
+  # Card
+  - title: Secure Surface devices
+    linkLists:
+      - linkListType: how-to-guide
+        links:
+          - text: Intune management of Surface UEFI settings
+            url: surface-manage-dfci-guide.md
+          - text: Surface Enterprise Management Mode (SEMM)
+            url: surface-enterprise-management-mode.md
+          - text: Surface Data Eraser tool
+            url: microsoft-surface-data-eraser.md
+
+  # Card
+  - title: Discover Surface tools
+    linkLists:
+      - linkListType: how-to-guide
+        links:
+          - text: Surface Dock Firmware Update
+            url: surface-dock-firmware-update.md
+          - text: Surface Diagnostic Toolkit for Business
+            url: surface-diagnostic-toolkit-for-business-intro.md
+          - text: SEMM and UEFI
+            url: surface-enterprise-management-mode.md
+          - text: Surface Brightness Control
+            url: microsoft-surface-brightness-control.md
+          - text: Battery Limit setting
+            url: battery-limit.md         
+
+  # Card
+  - title: Support and community 
+    linkLists:
+      - linkListType: learn
+        links:
+          - text: Top support solutions
+            url: support-solutions-surface.md
+          - text: Maximize your Surface battery life
+            url: https://support.microsoft.com/help/4483194/maximize-surface-battery-life
+          - text: Troubleshoot Surface Dock and docking stations
+            url: https://support.microsoft.com/help/4023468/surface-troubleshoot-surface-dock-and-docking-stations
+      - linkListType: reference
+        links:
+          - text: Surface IT Pro blog
+            url: https://techcommunity.microsoft.com/t5/Surface-IT-Pro-Blog/bg-p/SurfaceITPro
+          - text: Surface Devices Tech Community
+            url: https://techcommunity.microsoft.com/t5/Surface-Devices/ct-p/SurfaceDevices
--- a/devices/surface/manage-surface-driver-and-firmware-updates.md
+++ b/devices/surface/manage-surface-driver-and-firmware-updates.md
@ -14,18 +14,17 @@ author: dansimp
 ms.author: dansimp
 ms.topic: article
 ms.audience: itpro
-ms.date: 01/24/2020
+ms.date: 03/10/2020
 ---

 # Manage and deploy Surface driver and firmware updates
 
-
-How you manage Surface driver and firmware updates varies depending on your environment and organizational requirements. On Surface devices, firmware is exposed to the operating system as a driver and is visible in Device Manager, enabling device firmware and drivers to be automatically updated using Windows Update or Windows Update for Business. Although this simplified approach may be feasible for startups and small or medium-sized businesses, larger organizations typically need IT admins to distributing updates internally. This may involve comprehensive planning, application compatibility testing, piloting and validating updates, before final approval and distribution across the network.
+How you manage Surface driver and firmware updates varies depending on your environment and organizational requirements. On Surface devices, firmware is exposed to the operating system as a driver and is visible in Device Manager, enabling device firmware and drivers to be automatically updated using Windows Update or Windows Update for Business. Although this simplified approach may be feasible for startups and small or medium-sized businesses, larger organizations typically need IT admins to distribute updates internally. This may involve comprehensive planning, application compatibility testing, piloting and validating updates, before final approval and distribution across the network.

 > [!NOTE]
 > This article is intended for technical support agents and IT professionals and applies to Surface devices only. If you're looking for help to install Surface updates or firmware on a home device, see [Update Surface firmware and Windows 10](https://support.microsoft.com/help/4023505).
 
-While enterprise-grade software distribution solutions continue to evolve, the business rationale for centrally managing  updates remains the same: Maintain the security of Surface devices and keep them updated with the latest operating system and feature improvements. This is essential for maintaining the stability of your production environment and enabling users to stay productive. This article provides an overview of recommended tools and processes for larger organizations to accomplish these goals.
+While enterprise-grade software distribution solutions continue to evolve, the business rationale for centrally managing  updates remains the same: Maintain the security of Surface devices and keep them updated with the latest operating system and feature improvements. This is essential for sustaining a stable production environment and ensuring users aren't blocked from being productive. This article provides an overview of recommended tools and processes for larger organizations to accomplish these goals.

 ## Central update management in commercial environments

@ -33,7 +32,7 @@ Microsoft has streamlined tools for managing devices – including driver and fi

 ### Manage updates with Configuration Manager and Intune

-Microsoft Endpoint Configuration Manager allows you to synchronize and deploy Surface firmware and driver updates with the Configuration Manager client. Integration with Microsoft Intune lets you see all your managed, co-managed and partner-managed devices in one place. This is the recommended solution for large organizations to manage Surface updates.
+Microsoft Endpoint Configuration Manager allows you to synchronize and deploy Surface firmware and driver updates with the Configuration Manager client. Integration with Microsoft Intune lets you see all your managed, co-managed, and partner-managed devices in one place. This is the recommended solution for large organizations to manage Surface updates.
 
 For detailed steps, see the following resources:

@ -44,38 +43,42 @@ For detailed steps, see the following resources:

 ### Manage updates with Microsoft Deployment Toolkit

-Included in Microsoft Endpoint Configuration Manager, the Microsoft Deployment Toolkit (MDT) contains optional deployment tools that you may wish to use depending on your environment. MDT includes the Windows Assessment and Deployment Kit (Windows ADK), Windows System Image Manager (Windows SIM), Deployment Image Servicing and Management (DISM), and User State Migration Tool (USMT). You can download the latest version of MDT from the [Microsoft Deployment Toolkit download page](https://www.microsoft.com/download/details.aspx?id=54259).
+Included in Endpoint Configuration Manager, the Microsoft Deployment Toolkit (MDT) contains optional deployment tools that you may wish to use depending on your environment. These include the Windows Assessment and Deployment Kit (Windows ADK), Windows System Image Manager (Windows SIM), Deployment Image Servicing and Management (DISM), and User State Migration Tool (USMT). You can download the latest version of MDT from the [Microsoft Deployment Toolkit download page](https://www.microsoft.com/download/details.aspx?id=54259).
 
 For detailed steps, see the following resources:

-Surface driver and firmware updates are packaged as Windows Installer (MSI) files. To deploy these Windows Installer packages, you can use application deployment utilities such as the Microsoft Deployment Toolkit (MDT) or Microsoft Endpoint Configuration Manager. Such solutions provide the means for administrators to test and review updates before deploying them, and to centralize deployment. For each device, it is important to select the correct MSI file for the device and its operating system. For more information see [Deploy the latest firmware and drivers for Surface devices](deploy-the-latest-firmware-and-drivers-for-surface-devices.md).
-
-For instructions on how to deploy updates by using Microsoft Endpoint Configuration Manager refer to [Deploy applications with Configuration Manager](https://docs.microsoft.com/configmgr/apps/deploy-use/deploy-applications). For instructions on how to deploy updates by using MDT, see [Deploy a Windows 10 image using MDT](https://docs.microsoft.com/windows/deployment/deploy-windows-mdt/deploy-a-windows-10-image-using-mdt).
 - [Microsoft Deployment Toolkit documentation](https://docs.microsoft.com/configmgr/mdt/)
 - [Deploy Windows 10 with the Microsoft Deployment Toolkit](https://docs.microsoft.com/windows/deployment/deploy-windows-mdt/deploy-windows-10-with-the-microsoft-deployment-toolkit)
- [Deploy Windows 10 to Surface devices with Microsoft Deployment Toolkit](https://docs.microsoft.com/surface/deploy-windows-10-to-surface-devices-with-mdt)  
+- [Deploy Windows 10 to Surface devices with Microsoft Deployment Toolkit](https://docs.microsoft.com/surface/deploy-windows-10-to-surface-devices-with-mdt)
+
+Surface driver and firmware updates are packaged as Windows Installer (*.msi) files. To deploy these Windows Installer packages, you can use Endpoint Configuration Manager or MDT. For information about selecting the correct .msi file for a device and operating system, refer to the guidance below about downloading .msi files.
+
+For instructions on how to deploy updates by using Endpoint Configuration Manager refer to [Deploy applications with Configuration Manager](https://docs.microsoft.com/configmgr/apps/deploy-use/deploy-applications). For instructions on how to deploy updates by using MDT, see [Deploy a Windows 10 image using MDT](https://docs.microsoft.com/windows/deployment/deploy-windows-mdt/deploy-a-windows-10-image-using-mdt).
+

 **WindowsPE and Surface firmware and drivers**

-Microsoft Endpoint Configuration Manager and MDT both use the Windows Preinstallation Environment (WindowsPE) during the deployment process. WindowsPE only supports a limited set of basic drivers such as those for network adapters and storage controllers. Drivers for Windows components that are not part of WindowsPE might produce errors. As a best practice, you can prevent such errors by configuring the deployment process to use only the required drivers during the WindowsPE phase.
+Endpoint Configuration Manager and MDT both use the Windows Preinstallation Environment (WindowsPE) during the deployment process. WindowsPE only supports a limited set of basic drivers such as those for network adapters and storage controllers. Drivers for Windows components that are not part of WindowsPE might produce errors. As a best practice, you can prevent such errors by configuring the deployment process to use only the required drivers during the WindowsPE phase.

-### Microsoft Endpoint Configuration Manager
+### Endpoint Configuration Manager
+
+Starting in Endpoint Configuration Manager, you can synchronize and deploy Microsoft Surface firmware and driver updates by using the Configuration Manager client. For additional information, see KB 4098906, [How to manage Surface driver updates in Configuration Manager](https://support.microsoft.com/help/4098906/manage-surface-driver-updates-in-configuration-manager).

-Starting in Microsoft Endpoint Configuration Manager, you can synchronize and deploy Microsoft Surface firmware and driver updates by using the Configuration Manager client. The process resembles that for deploying regular updates. For additional information, see KB 4098906, [How to manage Surface driver updates in Configuration Manager](https://support.microsoft.com/help/4098906/manage-surface-driver-updates-in-configuration-manager).
 ## Supported devices
-Downloadable MSI files are available for Surface devices from Surface Pro 2 and later. Information about MSI files for the newest Surface devices such as Surface Pro 7, Surface Pro X, and Surface Laptop 3 will be available from this page upon release. 
+
+Downloadable .msi files are available for Surface devices from Surface Pro 2 and later. Information about .msi files for the newest Surface devices such as Surface Pro 7, Surface Pro X, and Surface Laptop 3 will be available from this page upon release. 


 ## Managing firmware with DFCI
+
 With Device Firmware Configuration Interface (DFCI) profiles built into Intune (now available in [public preview](https://docs.microsoft.com/intune/configuration/device-firmware-configuration-interface-windows)), Surface UEFI management extends the modern management stack down to the UEFI hardware level. DFCI supports zero-touch provisioning, eliminates BIOS passwords, provides control of security settings including boot options and built-in peripherals, and lays the groundwork for advanced security scenarios in the future. For more information, see:
 
-
 - [Intune management of Surface UEFI settings](https://docs.microsoft.com/surface/surface-manage-dfci-guide)
 - [Ignite 2019: Announcing remote management of Surface UEFI settings from Intune](https://techcommunity.microsoft.com/t5/Surface-IT-Pro-Blog/Ignite-2019-Announcing-remote-management-of-Surface-UEFI/ba-p/978333).

 ## Best practices for update deployment processes

-To maintain a stable environment and keep users productive, it’s strongly recommended to maintain parity with the most recent version of Windows 10.  For best practice recommendations, see [Build deployment rings for Windows 10 updates](https://docs.microsoft.com/windows/deployment/update/waas-deployment-rings-windows-10-updates).
+To maintain a stable environment, it's strongly recommended to maintain parity with the most recent version of Windows 10.  For best practice recommendations, see [Build deployment rings for Windows 10 updates](https://docs.microsoft.com/windows/deployment/update/waas-deployment-rings-windows-10-updates).

 ## Downloadable Surface update packages

@ -93,6 +96,7 @@ Specific versions of Windows 10 have separate .msi files, each containing all re


 ### Downloading .msi files
+
 1. Browse to [Download drivers and firmware for Surface](https://support.microsoft.com/help/4023482/surface-download-drivers-and-firmware) on the Microsoft Download Center.
 2. Select the .msi file name that matches the Surface model and version of Windows. The .msi file name includes the minimum supported Windows build number required to install the drivers and firmware. For example, as shown in the following figure, to update a Surface Book 2 with build 18362 of Windows 10, choose **SurfaceBook2_Win10_18362_19.101.13994.msi.** For a Surface Book 2 with build 16299 of Windows 10, choose **SurfaceBook2_Win10_16299_1803509_3.msi**.

@ -102,6 +106,7 @@ Specific versions of Windows 10 have separate .msi files, each containing all re
 
 
 ### Surface .msi naming convention
+
 Since August 2019, .msi files have used the following naming convention:

 - *Product*_*Windows release*_*Windows build number*_*Version number*_*Revision of version number (typically zero)*.
--- a/devices/surface/surface-system-sku-reference.md
+++ b/devices/surface/surface-system-sku-reference.md
@ -9,7 +9,7 @@ ms.sitesec: library
 author: dansimp
 ms.author: dansimp
 ms.topic: article
-ms.date: 10/31/2019
+ms.date: 03/09/2020
 ms.reviewer: 
 manager: dansimp
 ms.localizationpriority: medium
@ -24,18 +24,15 @@ System Model and System SKU are variables that are stored in the System Manageme

 | Device   | System Model | System SKU       |
 | ---------- | ----------- | -------------- |
-| AMD Surface Laptop 3                                         | Surface 3        | Surface_Laptop_3_1873       |
-| Surface Laptop 3                                             | Surface 3        | Surface_Laptop_3_1867:1868       |
-| Surface Laptop 3                                             | Surface 3        | Surface_3                   
 | Surface 3 WiFI                                               | Surface 3        | Surface_3                        |
 | Surface 3 LTE AT&T                                           | Surface 3        | Surface_3_US1                    |
 | Surface 3 LTE Verizon                                        | Surface 3        | Surface_3_US2                    |
 | Surface 3 LTE North America                                  | Surface 3        | Surface_3_NAG                    |
-| Surface 3 LTE Outside of North America and Y!mobile In Japan | Surface 3        | Surface_3_ROW                    |
+| Surface 3 LTE outside of North America and Y!mobile in Japan | Surface 3        | Surface_3_ROW                    |
 | Surface Pro                                                  | Surface Pro      | Surface_Pro_1796                 |
 | Surface Pro with LTE Advanced                                | Surface Pro      | Surface_Pro_1807                 |
-| Surface Book 2 13inch                                        | Surface Book 2   | Surface_Book_1832                |
-| Surface Book 2 15inch                                        | Surface Book 2   | Surface_Book_1793                |
+| Surface Book 2 13"                                        | Surface Book 2   | Surface_Book_1832                |
+| Surface Book 2 15"                                        | Surface Book 2   | Surface_Book_1793                |
 | Surface Go LTE Consumer  | Surface Go | Surface_Go_1825_Consumer |
 | Surface Go LTE Commercial | System Go | Surface_Go_1825_Commercial |
 | Surface Go Consumer                                          | Surface Go       | Surface_Go_1824_Consumer         |