Update Windows setup

Author: ntrogh

docs/setup/windows.md

@@ -11,60 +11,91 @@ MetaDescription: Get Visual Studio Code up and running on Windows
 
 ## Installation
 
-1. Download the [Visual Studio Code installer](https://go.microsoft.com/fwlink/?LinkID=534107) for Windows.
-2. Once it is downloaded, run the installer (VSCodeUserSetup-{version}.exe). This will only take a minute.
-3. By default, VS Code is installed under `C:\Users\{Username}\AppData\Local\Programs\Microsoft VS Code`.
+1. [Download and install Visual Studio Code](#install-vs-code-on-windows)
 
-Alternatively, you can also download a [Zip archive](/docs/?dv=winzip), extract it and run Code from there.
+    > [!NOTE]
+    > VS Code ships monthly releases and supports [auto-update](#updates) when a new release is available.
 
->**Tip:** Setup will add Visual Studio Code to your `%PATH%`, so from the console you can type 'code .' to open VS Code on that folder. You will need to restart your console after the installation for the change to the `%PATH%` environmental variable to take effect.
+1. [Install additional components](/docs/setup/additional-components.md)
 
-## User setup versus system setup
+    Install Git, Node.js, TypeScript, language runtimes, and more.
 
-VS Code provides both Windows **user** and **system** level setups.
+1. [Install VS Code extensions from the Visual Studio Marketplace](https://marketplace.visualstudio.com/VSCode)
+
+    Customize VS Code with themes, formatters, language extensions and debuggers for your favorite languages, and more.
+
+1. [Set up AI-assisted coding with GitHub Copilot](/docs/copilot/setup-simplified.md)
+
+    > [!TIP]
+    > If you don't yet have a Copilot subscription, you can use Copilot for free by signing up for the [Copilot Free plan](https://github.com/github-copilot/signup) and get a monthly limit of completions and chat interactions.
+
+1. [Get started with the VS Code tutorial](/docs/getstarted/getting-started.md)
+
+    Discover the user interface and key features of VS Code.
+
+## Install VS Code on Windows
 
-The [user setup](https://go.microsoft.com/fwlink/?LinkID=534107) does not require Administrator privileges to run as the location will be under your user Local AppData (`LOCALAPPDATA`) folder. Since it requires no elevation, the user setup is able to provide a smoother background update experience. This is the preferred way to install VS Code on Windows.
+### Use the Windows installer
 
->**Note:** When running VS Code as Administrator in a user setup installation, updates will be disabled.
+1. Download the [Visual Studio Code installer](https://go.microsoft.com/fwlink/?LinkID=534107) for Windows
 
-The [system setup](https://go.microsoft.com/fwlink/?linkid=852157) requires elevation to Administrator privileges to run and will place the installation under the system's Program Files. The in-product update flow will also require elevation, making it less streamlined than the user setup. On the other hand, installing VS Code using the system setup means that it will be available to all users in the system.
+1. Once it is downloaded, run the installer (VSCodeUserSetup-{version}.exe)
+
+    By default, VS Code is installed under `C:\Users\{Username}\AppData\Local\Programs\Microsoft VS Code`.
+
+> [!TIP]
+> Setup adds Visual Studio Code to your `%PATH%` environment variable, to let you type 'code .' in the console to open VS Code on that folder. You need to restart your console after the installation for the change to the `%PATH%` environmental variable to take effect.
+
+### Use the ZIP file
+
+1. Download the [Visual Studio Code Zip archive](/docs/?dv=winzip)
+
+1. Extract the Zip archive, and run VS Code from there
+
+## User setup versus system setup
+
+VS Code provides both Windows **user** and **system** level setups.
+
+| Setup Type | Description |
+|------------|-------------|
+| [User setup](https://go.microsoft.com/fwlink/?LinkID=534107) | Does not require administrator privileges to run, as the location is under your user Local AppData (`LOCALAPPDATA`) folder. Since it requires no elevation, the user setup is able to provide a smoother background update experience.<br/>This is the preferred way to install VS Code on Windows. <br/> **Note:** When running VS Code as Administrator in a user setup installation, updates are disabled. |
+| [System setup](https://go.microsoft.com/fwlink/?linkid=852157) | Requires elevation to administrator privileges to run and places the installation under the system's `Program Files`. The in-product update flow also requires elevation, making it less streamlined than the user setup. On the other hand, installing VS Code using the system setup means that it is available to all users in the system. |
 
 See the [Download Visual Studio Code](/download) page for a complete list of available installation options.
 
 ## Updates
 
 VS Code ships monthly [releases](/updates) and supports auto-update when a new release is available. If you're prompted by VS Code, accept the newest update and it will be installed (you won't need to do anything else to get the latest bits).
 
->**Note:** You can [disable auto-update](/docs/supporting/faq.md#how-do-i-opt-out-of-vs-code-autoupdates) if you prefer to update VS Code on your own schedule.
+> [!NOTE]
+> You can [disable auto-update](/docs/supporting/faq.md#how-do-i-opt-out-of-vs-code-autoupdates) if you prefer to update VS Code on your own schedule.
 
-## Windows Subsystem for Linux
+## Windows as a developer machine
 
-Windows is a popular operating system and it can be a great cross-platform development environment. This section describes cross-platform features such as the [Windows Subsystem for Linux](https://learn.microsoft.com/windows/wsl/install) (WSL) and the new Windows Terminal.
+Windows is a popular operating system and it can also be a great cross-platform development environment. This section describes cross-platform features such as the [Windows Subsystem for Linux](https://learn.microsoft.com/windows/wsl/install) (WSL) and the Windows Terminal.
 
-### Recent Windows build
+> [!NOTE]
+> Make sure you are on a recent Windows build. Check **Settings** > **Windows Update** to see if you are up-to-date.
 
-Make sure you are on a recent Windows 10 build. Check **Settings** > **Windows Update** to see if you are up-to-date.
+### Windows Subsystem for Linux
 
-### Windows as a developer machine
-
-With WSL, you can install and run Linux distributions on Windows. This enables you to develop and test your source code on Linux while still working locally on your Windows machine.
+With WSL, you can install and run Linux distributions on Windows to develop and test your source code on Linux, while still working locally on your Windows machine.
 
 When coupled with the [WSL](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl) extension, you get full VS Code editing and debugging support while running in the context of WSL.
 
-See the [Developing in WSL](/docs/remote/wsl.md) documentation to learn more or try the [Working in WSL](/docs/remote/wsl-tutorial.md) introductory tutorial.
+See the [Developing in WSL](/docs/remote/wsl.md) documentation to learn more, or try the [Working in WSL](/docs/remote/wsl-tutorial.md) introductory tutorial.
 
-### New Windows Terminal
+### Windows Terminal
 
-Available from the Microsoft Store, the [Windows Terminal (Preview)](https://www.microsoft.com/p/windows-terminal-preview/9n0dx20hk701?SilentAuth=1&wa=wsignin1.0&activetab=pivot%3Aoverviewtab) lets you easily open PowerShell, Command Prompt, and WSL terminals in a multiple tab shell.
+The [Windows Terminal](https://apps.microsoft.com/detail/9n0dx20hk701), available from the Microsoft Store, is a terminal application for users of command-line tools and shells like Command Prompt, PowerShell, and WSL. Its main features include multiple tabs, panes, Unicode and UTF-8 character support, a GPU accelerated text rendering engine, and custom themes, styles, and configurations.
 
 ## Next steps
 
-Once you have installed VS Code, these topics will help you learn more about VS Code:
+Once you have installed VS Code, these topics will help you learn more about it:
 
-* [Additional Components](/docs/setup/additional-components.md) - Learn how to install Git, Node.js, TypeScript, and tools like Yeoman.
-* [User Interface](/docs/getstarted/userinterface.md) - A quick orientation to VS Code.
-* [User/Workspace Settings](/docs/getstarted/settings.md) - Learn how to configure VS Code to your preferences through settings.
-* [Tips and Tricks](/docs/getstarted/tips-and-tricks.md) - Lets you jump right in and learn how to be productive with VS Code.
+* [VS Code tutorial](/docs/getstarted/getting-started.md) - A quick hands-on tour of the key features of VS Code.
+* [Tips and Tricks](/docs/getstarted/tips-and-tricks.md) - A collection of productivity tips for working with VS Code.
+* [AI-assisted coding](/docs/copilot/overview.md) - Learn about using GitHub Copilot in VS Code to help you write code faster.
 
 ## Common questions
 
@@ -75,34 +106,12 @@ for Windows. Thus, all the [Inno Setup command-line switches](https://www.jrsoft
 
 Additionally, you can prevent the Setup from launching VS Code after completion with `/mergetasks=!runcode`.
 
-### Scrolling is laggy and not smooth
-
-On certain devices, editor scrolling is not smooth but laggy for an unpleasant experience. If you notice this issue, make sure you install the Windows 10 October 2018 update where this issue is fixed.
-
 ### I'm having trouble with the installer
 
 Try using the [zip file](/docs/?dv=winzip) instead of the installer.  To use this, unzip VS Code in your `AppData\Local\Programs` folder.
 
->**Note:** When VS Code is installed via a Zip file, you will need to manually update it for each [release](/updates).
-
-### Icons are missing
-
-I installed Visual Studio Code on my Windows 8 machine. Why are some icons not appearing in the workbench and editor?
-
-VS Code uses [SVG](https://en.wikipedia.org/wiki/Scalable_Vector_Graphics) icons and we have found instances where the .SVG file extension is associated with something other than `image/svg+xml`. We're considering options to fix it, but for now here's a workaround:
-
-Using the Command Prompt:
-
-1. Open an Administrator Command Prompt.
-2. Type `REG ADD HKCR\.svg /f /v "Content Type" /t REG_SZ /d image/svg+xml`.
-
-Using the Registry Editor (regedit):
-
-1. Start `regedit`.
-2. Open the `HKEY_CLASSES_ROOT` key.
-3. Find the `.svg` key.
-4. Set its `Content Type` Data value to `image/svg+xml`.
-5. Exit `regedit`.
+> [!NOTE]
+> When VS Code is installed via a Zip file, you will need to manually update it for each [release](/updates).
 
 ### Unable to run as admin when AppLocker is enabled
 
@@ -122,13 +131,17 @@ Subscribe to [issue #122951](https://github.com/microsoft/vscode/issues/122951)
 
 ### Working with UNC paths
 
-Beginning with version `1.78.1`, VS Code on Windows will only allow to access UNC paths (these begin with a leading `\\`) that were either approved by the user on startup or where the host name is configured to be allowed via the new `setting(security.allowedUNCHosts)` setting.
+As of version `1.78.1`, VS Code on Windows only allows access to UNC paths (these begin with a leading `\\`) that were either approved by the user on startup or where the host name is configured to be allowed via the `setting(security.allowedUNCHosts)` setting.
+
+If you rely on using UNC paths in VS Code, you can either:
+
+* Configure the host to be allowed via the `setting(security.allowedUNCHosts)` setting. For example, add `server-a` when you open a path such as `\\server-a\path`.
+
+* [Map the UNC path as a network drive](https://support.microsoft.com/en-us/windows/map-a-network-drive-in-windows-29ce55d1-34e3-a7e2-4801-131475f9557d), and use the drive letter instead of the UNC path.
 
-If you rely on using UNC paths in VS Code, you can either
-* configure the host to be allowed via the `setting(security.allowedUNCHosts)` setting (for example add `server-a` when you open a path such as `\\server-a\path`)
-* map the UNC path as network drive and use the drive letter instead of the UNC path ([documentation](https://support.microsoft.com/en-us/windows/map-a-network-drive-in-windows-29ce55d1-34e3-a7e2-4801-131475f9557d))
-* define a global environment variable `NODE_UNC_HOST_ALLOWLIST` with the backslash-separated list of hostnames to allow, for example: `server-a\server-b` to allow the hosts `server-a` and `server-b`.
+* Define a global environment variable `NODE_UNC_HOST_ALLOWLIST` with the backslash-separated list of host names to allow. For example, `server-a\server-b` to allow the hosts `server-a` and `server-b`.
 
-*Note:* if you are using any of the remote extensions to connect to a workspace remotely (such as SSH), the `setting(security.allowedUNCHosts)` has to be configured on the remote machine and not the local machine.
+> [!NOTE]
+> If you are using any of the remote extensions to connect to a workspace remotely (such as SSH), the `setting(security.allowedUNCHosts)` has to be configured on the remote machine and not the local machine.
 
 This change was done to improve the security when using VS Code with UNC paths. Please refer to the associated [security advisory](https://github.com/microsoft/vscode/security/advisories/GHSA-mmfh-4pv3-39hr) for more information.