MDB - Windows App update

Author: RoseHJM

articles/dev-box/concept-dev-box-architecture.md

@@ -36,7 +36,7 @@ The network connection that is associated with a dev box pool determines where t
 
 Developers can create a dev box from a dev box pool by using the developer portal. They might choose from a specific pool based on the VM image, compute resources, or the location where the dev box is hosted.
 
-Once the dev box is running, dev box users can [remotely connect](#user-connectivity) to it by using a remote desktop client or directly from the browser. Dev box users have full control over the dev boxes they created, and can manage them from the developer portal. 
+Once the dev box is running, dev box users can [remotely connect](#user-connectivity) to it by using a Remote Desktop client like Windows App, or directly from the browser. Dev box users have full control over the dev boxes they created, and can manage them from the developer portal. 
 
 ## Microsoft Dev Box architecture
 
@@ -102,7 +102,7 @@ When you configure dev boxes to use [Microsoft Entra join](/azure/active-directo
 
 ### User connectivity
 
-When a dev box is running, developers can connect to the dev box by using a Remote Desktop client or directly from within the browser.
+When a dev box is running, developers can connect to the dev box by using a Remote Desktop client like Windows App, or directly from within the browser.
 
 Dev box connectivity is provided by Azure Virtual Desktop. No inbound connections direct from the Internet are made to the dev box. Instead, the following connections are made:
 

articles/dev-box/concept-dev-box-deployment-guide.md

@@ -39,7 +39,7 @@ Each of these roles has specific responsibilities during the deployment of Micro
 
 - **Developer**: self-serve one or more dev boxes within their assigned projects.
     - Create and manage a dev box based on project dev box pool from the developer portal
-    - Connect to a dev box by using remote desktop or from the browser
+    - Connect to a dev box by using a Remote Desktop client like Windows App
 
 :::image type="content" source="media/overview-what-is-microsoft-dev-box/dev-box-roles.png" alt-text="Diagram that shows roles and responsibilities for Dev Box platform engineers, team leads, and developers." lightbox="media/overview-what-is-microsoft-dev-box/dev-box-roles.png" border="false":::
 
@@ -250,11 +250,11 @@ Microsoft Dev Box uses Microsoft Intune to manage your dev boxes. Use Microsoft
 
 #### Device configuration
 
-After a dev box is provisioned, you can manage it like any other Windows device in Microsoft Intune. For example, you can create [device configuration profiles](/mem/intune/configuration/device-profiles) to turn different settings on and off in Windows, or push apps and updates to your users’ dev boxes.
+After a dev box is provisioned, you can manage it like any other Windows device in Microsoft Intune. For example, you can create [device configuration profiles](/mem/intune/configuration/device-profiles) to turn different settings on and off in Windows, or push apps and updates to your users' dev boxes.
 
 #### Configure conditional access policies
 
-You can use Intune to configure conditional access policies to control access to dev boxes. For Dev Box, it’s common to configure conditional access policies to restrict who can access dev box, what they can do, and where they can access from. To configure conditional access policies, you can use Microsoft Intune to create dynamic device groups and conditional access policies.
+You can use Intune to configure conditional access policies to control access to dev boxes. For Dev Box, it's common to configure conditional access policies to restrict who can access dev box, what they can do, and where they can access from. To configure conditional access policies, you can use Microsoft Intune to create dynamic device groups and conditional access policies.
 
 Some usage scenarios for conditional access in Microsoft Dev Box include: 
 
@@ -266,7 +266,7 @@ Learn how you can [configure conditional access policies for Dev Box](./how-to-c
 
 #### Privilege management
 
-You can configure Microsoft Intune Endpoint Privilege Management (EPM) for dev boxes so that dev box users don't need local administrative privileges. Microsoft Intune Endpoint Privilege Management allows your organization’s users to run as a standard user (without administrator rights) and complete tasks that require elevated privileges. Tasks that commonly require administrative privileges are application installs (like Microsoft 365 Applications), updating device drivers, and running certain Windows diagnostics.
+You can configure Microsoft Intune Endpoint Privilege Management (EPM) for dev boxes so that dev box users don't need local administrative privileges. Microsoft Intune Endpoint Privilege Management allows your organization's users to run as a standard user (without administrator rights) and complete tasks that require elevated privileges. Tasks that commonly require administrative privileges are application installs (like Microsoft 365 Applications), updating device drivers, and running certain Windows diagnostics.
 
 Learn more about how to [configure Microsoft Intune Endpoint Privilege for Microsoft Dev Box](./how-to-elevate-privilege-dev-box.md).
 

articles/dev-box/dev-box-faq.yml

@@ -41,7 +41,7 @@ sections:
     
       - question: Can I use a smart card, or other physical device with Dev Box?
         answer: Yes. Dev Box users can use smart card and other devices that are connected to the physical machine. Since Dev Box uses same RDP client as Azure Virtual Desktop, you can review following documentation to learn about all the different capabilities supported by RDP client. You can also review RDP client capabilities on different operating systems.
-                [Compare the features of remote desktop clients - Redirection comparison](../virtual-desktop/compare-remote-desktop-clients.md#redirection)
+                [Compare the features of Remote Desktop clients - Redirection comparison](../virtual-desktop/compare-remote-desktop-clients.md#redirection)
 
       - question: Can I use Linux as my development environment?
         answer: Microsoft Dev Box supports Windows Subsystem for Linux (WSL) for Linux scenarios. This support enables users to use Linux environment alongside Windows tools. GitHub users who use VS Code for development can use GitHub Codespaces.  

articles/dev-box/how-to-configure-multiple-monitors.md

@@ -26,6 +26,9 @@ When you connect to your cloud-hosted developer machine in Microsoft Dev Box by
 | Remote Desktop Connection (MSTSC) | <sub>:::image type="icon" source="./media/how-to-configure-multiple-monitors/yes.svg" border="false":::</sub> | [Microsoft Remote Desktop Connection](/azure/dev-box/how-to-configure-multiple-monitors?branch=main&tabs=windows-connection#configure-remote-desktop-to-use-multiple-monitors) |
 | Microsoft Remote Desktop for macOS  | <sub>:::image type="icon" source="./media/how-to-configure-multiple-monitors/yes.svg" border="false":::</sub> | [Microsoft Remote Desktop for macOS](/azure/dev-box/how-to-configure-multiple-monitors?branch=main&tabs=macOS#configure-remote-desktop-to-use-multiple-monitors) |
 
+
+[!INCLUDE [note-windows-app](includes/note-windows-app.md)]
+
 ## Prerequisites
 
 To complete the steps in this article, you must install the appropriate Remote Desktop client on your local machine.

articles/dev-box/how-to-create-dev-boxes-developer-portal.md

@@ -41,7 +41,7 @@ You can also create a dev box through the Azure CLI dev center extension. For mo
 
 After you create your dev box, you can connect to it through a remote application or via the browser.
 
-A remote desktop client application like Windows App provides the highest performance and best user experience for heavy workloads. Windows App also supports multi-monitor configuration. For more information, see [Get started with Windows App](/windows-app/get-started-connect-devices-desktops-apps?context=/azure/dev-box/context/context&pivots=dev-box).
+A remote desktop client application like Windows App provides the highest performance and best user experience for heavy workloads. Windows App also supports multi-monitor configuration. For more information, see [Get started with Windows App](https://aka.ms/dev-box/windows-app).
 
 You can use the **browser** for lighter workloads. When you access your dev box via your phone or laptop, you can use the browser. The browser is useful for tasks such as a quick bug fix or a review of a GitHub pull request. For more information, see the [steps for using a browser to connect to a dev box](./quickstart-create-dev-box.md#connect-to-a-dev-box).
 

articles/dev-box/how-to-enable-single-sign-on.md

@@ -88,9 +88,9 @@ If you disable single sign-on for a pool, new dev boxes created from that pool p
 
 When single sign-on is enabled for a pool, your sign-on experience is as follows:
 
-The first time you connect to a dev box with single sign-on enabled, you first sign into your physical machine. Then you connect to your dev box from the Remote Desktop app or the developer portal. When the dev box starts up, you must enter your credentials to access the dev box. 
+The first time you connect to a dev box with single sign-on enabled, you first sign into your physical machine. Then you connect to your dev box from a remote desktop client like Windows App or the developer portal. When the dev box starts up, you must enter your credentials to access the dev box. 
 
-The next time you connect to your dev box, whether through the Remote Desktop app or through the developer portal, you don't have to enter your credentials. 
+The next time you connect to your dev box, whether through the Windows App or through the developer portal, you don't have to enter your credentials. 
 
 If your connection to your dev box is interrupted because your client machine goes to sleep, you see a message explaining the issue, and you can reconnect by selecting the **Reconnect** button. You don't have to reenter your credentials. 
 

articles/dev-box/how-to-hibernate-your-dev-box.md

@@ -42,7 +42,7 @@ To resume your dev box through the Microsoft Dev Box developer portal:
 
 1. On the dev box you want to resume, on the more options menu, select **Resume**. 
 
-In addition, you can also double select on your dev box  in the list of VMs you see in the "Remote Desktop" app. Your dev box automatically starts up and resumes from a hibernating state. 
+In addition, you can also double select on your dev box  in the list of VMs you see in the Windows App. Your dev box automatically starts up and resumes from a hibernating state. 
 
 ## Hibernate your dev box using the Azure CLI
 

articles/dev-box/how-to-troubleshoot-repair-dev-box.md

@@ -1,5 +1,5 @@
 ---
-title: Troubleshoot and repair Dev Box RDP connectivity issues 
+title: Troubleshoot and repair Remote Desktop connectivity issues 
 description: Having problems connecting to your dev box remotely? Learn how to troubleshoot and resolve connectivity issues to your dev box with developer portal tools. 
 author: RoseHJM 
 ms.author: rosemalcolm 
@@ -10,9 +10,9 @@ ms.date: 01/10/2024
 #CustomerIntent: As a dev box user, I want to be able to troubleshoot and repair connectivity issues with my dev box so that I don't lose development time.
 ---
 
-# Troubleshoot and resolve dev box remote desktop connectivity issues 
+# Troubleshoot and resolve dev box Remote Desktop connectivity issues 
 
-In this article, you learn how to troubleshoot and resolve remote desktop connectivity (RDC) issues with your dev box. Because RDC issues to your dev box can be time consuming to resolve manually, use the **Troubleshoot & repair** tool in the developer portal to diagnose and repair some common dev box connectivity issues.
+In this article, you learn how to troubleshoot and resolve Remote Desktop Connectivity (RDC) issues with your dev box. Because RDC issues to your dev box can be time consuming to resolve manually, use the **Troubleshoot & repair** tool in the developer portal to diagnose and repair some common dev box connectivity issues.
 
 :::image type="content" source="media/how-to-troubleshoot-repair-dev-box/dev-box-troubleshoot-repair-tool.png" alt-text="Screenshot showing the Troubleshoot and repair tool in the Microsoft developer portal." lightbox="media/how-to-troubleshoot-repair-dev-box/dev-box-troubleshoot-repair-tool.png":::
 

articles/dev-box/includes/note-windows-app.md

@@ -0,0 +1,10 @@
+---
+author: RoseHJM
+ms.author: rosemalcolm
+ms.date: 10/07/2024
+ms.topic: include
+ms.service: dev-box
+---
+
+> [!NOTE]
+> The new Windows App remote desktop client is the recommended client for Microsoft Dev Box; it provides an enhanced user experience, including support for multiple monitors. It is also available on multiple platforms, including Windows, macOS, iOS/iPadOS, Android/Chrome OS (preview), and web browsers. For more information, see [Get started with Windows App](https://aka.ms/dev-box/windows-app).

articles/dev-box/overview-what-is-microsoft-dev-box.md

@@ -1,6 +1,6 @@
 ---
 title: What is Microsoft Dev Box?
-description: Explore Microsoft Dev Box for self-service access to ready-to-code cloud-based workstations and developer productivity that integrates with tools like Visual Studio.
+description: Explore Microsoft Dev Box for self-service ready-to-code cloud-based workstations and developer productivity that integrates with tools like Visual Studio.
 services: dev-box
 ms.service: dev-box
 ms.topic: overview
@@ -14,7 +14,7 @@ adobe-target: true
 
 Microsoft Dev Box gives developers self-service access to ready-to-code cloud workstations called *dev boxes*. You can configure dev boxes with tools, source code, and prebuilt binaries that are specific to a project, so developers can immediately start work. You can create your own customized image, or use a preconfigured image from Azure Marketplace, complete with Visual Studio already installed. 
 
-If you're a developer, you can use multiple dev boxes in your day-to-day workflows. You can access your dev boxes through a remote desktop client, or through a web browser, like any virtual desktop.
+If you're a developer, you can use multiple dev boxes in your day-to-day workflows. You can access your dev boxes through a Remote Desktop client like Windows App, or through a web browser, like any virtual desktop.
 
 The Dev Box service was designed with three organizational roles in mind: platform engineers, development team leads, and developers.