Merge pull request #6127 from MicrosoftDocs/main

Auto Publish – main to live - 2025-12-16 05:00 UTC

Author: learn-build-service-prod[bot]

.openpublishing.redirection.json

@@ -10394,6 +10394,26 @@
       "source_path": "hub/apps/design/motion/motion-reposition.md",
       "redirect_url": "/previous-versions/windows/uwp/ui-input/motion-reposition",
       "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/winui/winui3/create-your-first-winui3-app.md",
+      "redirect_url": "/hub/apps/get-started/start-here.md",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/windows-app-sdk/set-up-your-development-environment.md",
+      "redirect_url": "/hub/apps/get-started/start-here.md",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "hub/apps/how-tos/hello-world-winui3.md",
+      "redirect_url": "/hub/apps/get-started/start-here.md",
+      "redirect_document_id": false
+    }, 
+    {
+      "source_path": "hub/apps/winui/index.md",
+      "redirect_url": "/hub/apps/winui3/index.md",
+      "redirect_document_id": false
     }
   ]
 }

hub/advanced-settings/sudo/index.md

@@ -49,15 +49,26 @@ Update `<configuration_option>` to either `forceNewWindow`, `disableInput`, or `
 
 To use Sudo for Windows, simply prepend `sudo` to the command you want to run as an administrator. For example, to run `netstat -ab` as an administrator, you would run `sudo netstat -ab` in your console window.
 
+### Common developer scenarios
+
+Here are some common scenarios where developers might use sudo:
+
+- **Editing system files**: `sudo notepad C:\Windows\System32\drivers\etc\hosts`
+- **Installing packages globally**: `sudo npm install -g package-name`
+- **Running administrative tools**: `sudo diskpart`
+
+> [!NOTE]
+> For development work involving system directories like `C:\Windows\`, consider using development environments or alternative approaches when possible. Sudo should be used judiciously and only when elevated permissions are truly necessary.
+
 Because `sudo` elevates the targeted process to run with administrator-level permission, a prompt will open asking you to verify that you want to continue.
 
 ## Security Considerations
 
-There are risks associated with running sudo in the **Input closed** (`inputClosed`) or **Inline** (`normal`) configurations. It is possible for malicious processes to attempt to drive the elevated process using the connection established by the unelevated sudo.exe and the elevated sudo.exe process.
+There are risks associated with running sudo in the **Input closed** (`disableInput`) or **Inline** (`normal`) configurations. It is possible for malicious processes to attempt to drive the elevated process using the connection established by the unelevated sudo.exe and the elevated sudo.exe process.
 
-The `inputClosed` configuration option mitigates risk by closing the input handle. Disconnecting the input handle from the current console window means that unelevated processes cannot send input to the elevated process.
+The `disableInput` configuration option mitigates risk by closing the input handle. Disconnecting the input handle from the current console window means that unelevated processes cannot send input to the elevated process.
 
-The `inline` configuration option runs the elevated process in the current window and the process is able to receive input from the current console session. An unelevated process can send input to the elevated process within the same console windows or get information from the output in the current windows in this configuration.
+The `inline` configuration option runs the elevated process in the current window and the process is able to receive input from the current console session. An unelevated process can send input to the elevated process within the same console window or get information from the output in the current window in this configuration.
 
 ## FAQ
 
@@ -75,7 +86,7 @@ The `inline` configuration option runs the elevated process in the current windo
 
 - `sudo` can only be elevated via the User Account Control (UAC) security feature designed to protect the operating system from unauthorized changes using verification prompt.
 
-You should consider your particular use-case and plan to use the command that best meets your needs. You should also consider the security implications of running sudo in the `inputClosed` and `normal` modes. The default `forceNewWindow` configuration option is recommended unless you are familiar and comfortable with the risks associated with the other `sudo` configurations.
+You should consider your particular use-case and plan to use the command that best meets your needs. You should also consider the security implications of running sudo in the `disableInput` and `normal` modes. The default `forceNewWindow` configuration option is recommended unless you are familiar and comfortable with the risks associated with the other `sudo` configurations.
 
 ## Sudo for Windows open source repository
 

hub/apps/get-started/start-here.md

@@ -10,10 +10,9 @@ ms.collection: windows11
 
 # Setup and tooling for WinUI
 
-Welcome to Windows app development. This guide will take you through the steps needed to begin creating your first app with WinUI. It will also point you to resources that will help you learn more about Windows development.
+This guide walks you through setting up your WinUI and Windows App SDK development environment in Visual Studio and creating your first app.
 
-
-## 1. Enable Developer Mode
+### 1. Enable Developer Mode
 
 Windows has a special mode for developers that adjusts security settings so you can run the apps you're working on. You need to enable Developer Mode before you can build, deploy, and test your app by using Visual Studio.
 
@@ -28,7 +27,7 @@ To enable Developer Mode:
 For more information about Developer Mode, see [Settings for developers](/windows/advanced-settings/developer-mode).
 
 
-## 2. Install Visual Studio and required workloads
+### 2. Install Visual Studio and required workloads
 
 Use [Visual Studio](/visualstudio/ide/), Microsoft’s powerful IDE, to build, debug, and deploy your WinUI app. It offers ready-to-use project templates for Windows and other platforms to help you get started quickly.
 
@@ -75,7 +74,7 @@ On the **Workloads** tab of the Visual Studio Installer app, select the followin
 
 ---
 
-## 3. Create and launch your first WinUI app
+### 3. Create and launch your first WinUI app
 
 Visual Studio project templates include all the files you need to quickly create your app. In fact, after you create your project from a WinUI app template, you already have an app that you can run, and then add your code to.
 
@@ -105,7 +104,7 @@ Congratulations, you've just built your first WinUI app! Continue with the next
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Build your first notetaking app with WinUI](../tutorials/winui-notes/intro.md)
+> [Build your first app with WinUI](../tutorials/winui-notes/intro.md)
 
 * To get an idea of what WinUI offers, check out the WinUI Gallery app.
   [!INCLUDE [winui-3-gallery](../../includes/winui-3-gallery.md)]