Merge pull request #6 from MicrosoftDocs/release-17.4

merging from Docs/Release 17.4

Author: christineruana

.openpublishing.redirection.json

@@ -1,5 +1,10 @@
 {
   "redirections": [
+    {
+      "source_path": "docs/msbuild/updating-an-existing-application.md",
+      "redirect_url": "/visualstudio/msbuild/find-and-use-msbuild-versions",
+      "redirect_document_id": true
+    },
     {
       "source_path": "docs/python/managing-python-on-azure-app-service.md",
       "redirect_url": "/azure/app-service/quickstart-python",

docs/designers/disable-dpi-awareness.md

@@ -1,7 +1,7 @@
 ---
 title: Disable DPI-awareness for scaling in forms
 description: Fix scaling issues with Windows Forms Designer on HDPI monitors.
-ms.date: 10/20/2022
+ms.date: 10/31/2022
 author: TerryGLee
 ms.author: tglee
 manager: jmartens
@@ -13,9 +13,9 @@ ms.custon: contperf-fy22q2
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
 
-In this article, you'll learn the limitations of Windows Forms Designer on HDPI monitors and [how to run Visual Studio as a DPI-unaware process](#resolve-hdpi-display-problems).
+In this article, you'll learn about the limitations of Windows Forms Designer on HDPI monitors and [how to run Visual Studio as a DPI-unaware process](#resolve-hdpi-display-problems).
 
-Visual Studio is a dots per inch (DPI) aware application, which means the display scales automatically. If an application states that it's not DPI-aware, the operating system scales the application as a bitmap. This behavior is also called DPI virtualization. The application still thinks that it's running at 100% scaling, or 96 dpi.
+Visual Studio is a dots per inch (DPI) aware application, which means the display scales automatically. If an application states that it's not DPI-aware, the operating system scales the application as a bitmap. This behavior is also called DPI virtualization. The application still thinks that it's running at 100% scaling, or 96 DPI.
 
 You can also:
 + [Automatically scale in Windows Forms](/dotnet/framework/winforms/automatic-scaling-in-windows-forms)
@@ -27,81 +27,69 @@ Since the **Windows Forms Designer** in Visual Studio doesn't have scaling suppo
 
 ![Windows Forms Designer on HDPI monitor](./media/win-forms-designer-hdpi-1.gif)
 
-If you aren't working in the designer and don't need to adjust the layout of your form, you can ignore the informational bar and continue working in the code editor or in other types of designers. (You can also [disable notifications](#disable-notifications) so that the informational bar doesn't continue to appear.) Only the **Windows Forms Designer** is affected.
+### Use the information bar
 
-When you open a form in the **Windows Forms Designer** on an HDPI monitor, Visual Studio displays an informational bar.
-
-:::image type="content" source="media/scaling-gold-bar-message-1.png" alt-text="Screenshot of the informational bar in Visual Studio to restart in DPI-unaware mode.":::
+When you open a form in the **Windows Forms Designer** on an HDPI monitor, Visual Studio displays an information bar.
 
+:::image type="content" source="media/scaling-gold-bar-message-1.png" alt-text="Screenshot of the information bar in Visual Studio to restart in DPI-unaware mode.":::
 
+If you aren't working in the designer and don't need to adjust the layout of your form, you can ignore the information bar and continue working in the code editor or in other types of designers. (You can also [disable notifications](#disable-notifications) so that the information bar doesn't continue to appear.) Only the **Windows Forms Designer** is affected.
 
 > [!TIP]
-> If you've closed the informational bar at the top of the designer, but you still want to replicate the behavior of the link that says **Restart Visual Studio with 100% scaling**, you still can. Select **Tools** > **Command Line** > **Developer Command Prompt** from the Visual Studio menu bar. Then, enter `devenv /noScale`.
+> If you've closed the information bar but you still want restart Visual Studio with 100% scaling, you can. [Use the DevEnv.exe tool](#use-the-devenvexe-tool) to do so.
 
 ## Resolve HDPI display problems
 
-There are three options to resolve the display problem:
+There are several options to resolve the display problem:
 
 - [Restart Visual Studio as a DPI-unaware process](#restart-visual-studio-as-a-dpi-unaware-process)
-- [Add a registry entry](#add-a-registry-entry)
+<!-- - [Add a registry entry](#add-a-registry-entry) -->
 - [Set your display scaling setting to 100%](#set-your-display-scaling-setting-to-100)
-
-> [!TIP]
-> If you prefer to manage settings from the command line, [`devenv.exe`](../ide/reference/devenv-command-line-switches.md) takes `/noscale` as a command-line parameter to run in 100% scaling mode.
+- [Use the DevEnv.exe tool](#use-the-devenvexe-tool)
 
 ### Restart Visual Studio as a DPI-unaware process
 
-The preferred solution to this issue is to restart Visual Studio as a DPI-unaware process. Do so by selecting the option on the yellow informational bar.
+The preferred solution to this issue is to restart Visual Studio as a DPI-unaware process. Do so by selecting the option on the yellow information bar.
 
-When Visual Studio runs as a DPI-unaware process, the designer layout issues are resolved, but fonts may appear blurry and you may see issues in other designers such as the **XAML Designer**.. Visual Studio displays a different yellow informational message when it runs as a DPI-unaware process that says **Visual Studio is running as a DPI-unaware process. WPF and XAML designers might not display correctly.** The informational bar also provides an option to **Restart Visual Studio as a DPI-aware process**.
+When Visual Studio runs as a DPI-unaware process, the designer layout issues are resolved, but fonts may appear blurry and you may see issues in other designers such as the **XAML Designer**. Visual Studio displays a different yellow informational message when it runs as a DPI-unaware process that says **Visual Studio is running as a DPI-unaware process. WPF and XAML designers might not display correctly.** The informational bar also provides an option to **Restart Visual Studio as a DPI-aware process**.
 
 ::: moniker range="<=vs-2019"
 
 > [!NOTE]
-> - If you have undocked tool windows in Visual Studio when you select the option to restart as a DPI-unaware process, the position of the tool windows might change.
+> - If you have undocked [tool windows](../ide/customizing-window-layouts-in-visual-studio.md#tool-and-document-windows) in Visual Studio when you select the option to restart as a DPI-unaware process, the position of the tool windows might change.
 > - If you use the default Visual Basic profile, or if you have the **Save new projects when created** option deselected in **Tools** > **Options** > **Projects and Solutions**, Visual Studio cannot reopen your project when it restarts as a DPI-unaware process. However, you can open the project by selecting it under **File** > **Recent Projects and Solutions**.
 
 ::: moniker-end
 
 ::: moniker range=">=vs-2022"
 
 > [!NOTE]
-> - If you have undocked tool windows in Visual Studio when you select the option to restart as a DPI-unaware process, the position of the tool windows might change.
+> - If you have undocked [tool windows](../ide/customizing-window-layouts-in-visual-studio.md#tool-and-document-windows) in Visual Studio when you select the option to restart as a DPI-unaware process, the position of the tool windows might change.
 > - If you use the default Visual Basic profile, Visual Studio cannot reopen your project when it restarts as a DPI-unaware process. However, you can open the project by selecting it under **File** > **Recent Projects and Solutions**.
 
 ::: moniker-end
 
 It's important to restart Visual Studio as a DPI-aware process when you're finished working in the **Windows Forms Designer**. If you close and reopen Visual Studio when it's running in DPI-unaware mode, it becomes DPI-aware again. You can also select the **Restart Visual Studio as a DPI-aware process** option in the informational bar.
 
-### Add a registry entry
-
-As option two, you can mark Visual Studio as DPI-unaware by modifying the registry. Open **Registry Editor** and add an entry to the **HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows NT\CurrentVersion\AppCompatFlags\Layers** subkey:
-
-**Entry**: Depending on whether you're using Visual Studio 2017, 2019, or 2022, use one of these values:
-
-- C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE\devenv.exe
-- C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\Common7\IDE\devenv.exe
-- C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\IDE\devenv.exe
-
-> [!NOTE]
-> If you're using the Professional or Enterprise edition of Visual Studio, replace **Community** with **Professional** or **Enterprise** in the entry. Also replace the drive letter as necessary.
+### Set your display scaling setting to 100%
 
-**Type**: REG_SZ <br>
-**Value**: DPIUNAWARE
+A third option to resolving the issue is to set your display scaling setting to 100% in Windows 10, type **display settings** in the task bar search box, and then select **Change display settings**. In the **Settings** window, set **Change the size of text, apps, and other items** to **100%**.  However, setting your display scaling to 100% may be undesirable since it can make the user interface too small to be usable.
 
-Visual Studio remains in DPI-unaware mode until you remove the registry entry.
+### Use the DevEnv.exe tool
 
-### Set your display scaling setting to 100%
+If you prefer to manage settings from the command line, [`devenv.exe`](../ide/reference/devenv-command-line-switches.md) takes `/noscale` as a command-line parameter to run in 100% scaling mode. Here's how:
 
-A third option to resolving the issue is to set your display scaling setting to 100% in Windows 10, type **display settings** in the task bar search box, and then select **Change display settings**. In the **Settings** window, set **Change the size of text, apps, and other items** to **100%**.  However, setting your display scaling to 100% may be undesirable since it can make the user interface too small to be usable.
+1. Select **Tools** > **Command Line** > **Developer Command Prompt** from the Visual Studio menu bar.
+1. Then, enter `devenv /noScale`.
 
 ## Disable notifications
 
 You can choose not to be notified of DPI scaling issues in Visual Studio. You might want to disable notifications if you aren't working in the designer, for example.
 
 To disable notifications:
+
 1. Choose **Tools** > **Options** to open the **Options** dialog.
-2. In the **Options** dialog, choose **Windows Forms Designer** > **General**, and set **DPI Scaling Notifications** to **False**.
+1. In the **Options** dialog, choose **Windows Forms Designer** > **General**, and set **DPI Scaling Notifications** to **False**.
 
 If you want to later reenable scaling notifications, set the property to **True**.
 

docs/get-started/includes/ide-overview.md

@@ -29,7 +29,7 @@ The preceding image shows Visual Studio with an open project that shows key wind
 - The central [editor window](../../ide/writing-code-in-the-code-and-text-editor.md), where you'll probably spend most of your time, displays file contents. In the editor window, you can edit code or design a user interface such as a window with buttons and text boxes.
 
 
-- In [Git Changes](/visualstudio/version-control/) at lower right, you can track work items and share code with others by using version control technologies like [Git](https://git-scm.com/) and [GitHub](https://docs.github.com/).
+- In [Git Changes](/visualstudio/version-control/) at lower right, you can track work items and share code with others by using version control technologies like [Git](https://git-scm.com/) and [GitHub](https://github.com/).
 
 ## Editions
 

docs/get-started/visual-basic/visual-studio-ide.md

@@ -42,7 +42,7 @@ The preceding image shows Visual Studio with an open Visual Basic project that s
 ::: moniker-end
 
 ::: moniker range=">=vs-2022"
-- In [Git Changes](/visualstudio/version-control/) at lower right, you can track work items and share code with others by using version control technologies like [Git](https://git-scm.com/) and [GitHub](https://docs.github.com/).
+- In [Git Changes](/visualstudio/version-control/) at lower right, you can track work items and share code with others by using version control technologies like [Git](https://git-scm.com/) and [GitHub](https://github.com/).
 ::: moniker-end
 
 ## Editions

docs/ide/create-new-project.md

@@ -2,7 +2,7 @@
 title: Create a new project
 description: Learn how to create a new project in Visual Studio.
 ms.custom: SEO-VS-2020
-ms.date: 11/24/2021
+ms.date: 10/28/2022
 ms.topic: how-to
 f1_keywords:
 - vs.newproject
@@ -59,7 +59,7 @@ If you're not selecting from the recently used templates, you can filter all ava
 
 :::image type="content" source="media/vs-2019/create-new-project-filters.png" alt-text="Screenshot of the project template filters in Visual Studio 2019.":::
 
-The tags that appear under each template correspond to the three dropdown filters (Language, platform, and project type).
+The tags that appear under each template correspond to the three dropdown filters (language, platform, and project type).
 
 > [!TIP]
 > If you don't see the template you're looking for, you might be missing a workload for Visual Studio. To install additional workloads, for example, **Azure Development** or **Mobile Development with .NET**, select the **Install more tools and features** link to open Visual Studio Installer. From there, select the workloads you want to install, and then select **Modify**. After that, additional project templates will be available to choose from.
@@ -74,7 +74,7 @@ Select a template and then select **Next**.
 
 :::image type="content" source="media/vs-2022/create-new-project-filters.png" alt-text="Screenshot of the project template filters in Visual Studio 2022.":::
 
-The tags that appear under each template correspond to the three dropdown filters (Language, platform, and project type).
+The tags that appear under each template correspond to the three dropdown filters (language, platform, and project type).
 
 > [!TIP]
 > If you don't see the template you're looking for, you might be missing a workload for Visual Studio. To install additional workloads, for example, **Azure Development** or **Mobile Development with .NET**, select the **Install more tools and features** link to open Visual Studio Installer. From there, select the workloads you want to install, and then select **Modify**. After that, additional project templates will be available to choose from.
@@ -118,16 +118,13 @@ Select **Create** to create the new project.
 
 ::: moniker-end
 
-## Add additional projects to a solution
+## Add another project to a solution
 
-If you want to add an additional project to a solution, right-click the solution node in **Solution Explorer** and then select **Add** > **New Project**.
+If you want to add another project to a solution, right-click the solution node in **Solution Explorer** and then select **Add** > **New Project**.
 
 > [!TIP]
 > For an example of a project and solution created from scratch, complete with step-by-step instructions and sample code, see [Introduction to projects and solutions](../get-started/tutorial-projects-solutions.md).
 
 ## See also
 
-- [Introduction to projects and solutions](../get-started/tutorial-projects-solutions.md)
-- [Work with solutions and projects](creating-solutions-and-projects.md)
-- [Manage project and solution properties](managing-project-and-solution-properties.md)
-- [Create projects (Visual Studio for Mac)](/visualstudio/mac/create-new-projects)
+- [Visual Studio for Mac: Create a new project](/visualstudio/mac/create-new-projects)

docs/ide/media/vs-2022/start-window-create-new-project.png

@@ -21,7 +21,7 @@ Visual Studio consists of client software applications and connected experiences
 
 ## Choose whether these connected experiences are available to use ##
 
-You can choose which connected experiences to use. Use of certain connected experiences require agreement to different and additional terms to the Visual Studio EULA. These experiences may be Microsoft-owned online services and/or services owned by third-parties. For example, when you use GitHub connected experiences, the [GitHub Privacy Statement](https://docs.github.com/github/site-policy/github-privacy-statement) and [GitHub Terms of Service](https://docs.github.com/github/site-policy/github-terms-of-service), [GitHub Corporate Terms of Service](https://docs.github.com/github/site-policy/github-corporate-terms-of-service), and/or [Additional Product Terms](https://docs.github.com/github/site-policy/github-additional-product-terms) will apply. If you [Report A Problem](../how-to-report-a-problem-with-visual-studio.md), you agree to the [Microsoft Terms of Use](https://www.microsoft.com/legal/terms-of-use) and the [Microsoft Privacy Statement](https://privacy.microsoft.com/en-us/privacystatement). If you use the NuGet service, you agree to the [NuGet Terms of Use](https://www.nuget.org/policies/Terms) and the [Microsoft Privacy Statement](https://privacy.microsoft.com/en-us/privacystatement). 
+You can choose which connected experiences to use. Use of certain connected experiences require agreement to different and additional terms to the Visual Studio EULA. These experiences may be Microsoft-owned online services and/or services owned by third-parties. For example, when you use GitHub connected experiences, the [GitHub Privacy Statement](https://docs.github.com/en/site-policy/privacy-policies/github-privacy-statement) and [GitHub Terms of Service](https://docs.github.com/en/site-policy/github-terms/github-terms-of-service), [GitHub Corporate Terms of Service](https://docs.github.com/en/site-policy/github-terms/github-corporate-terms-of-service), and/or [Additional Product Terms](https://docs.github.com/en/site-policy/github-terms/github-terms-for-additional-products-and-features) will apply. If you [Report A Problem](../how-to-report-a-problem-with-visual-studio.md), you agree to the [Microsoft Terms of Use](https://www.microsoft.com/legal/terms-of-use) and the [Microsoft Privacy Statement](https://privacy.microsoft.com/en-us/privacystatement). If you use the NuGet service, you agree to the [NuGet Terms of Use](https://www.nuget.org/policies/Terms) and the [Microsoft Privacy Statement](https://privacy.microsoft.com/en-us/privacystatement). 
 
 When you install Visual Studio, [you may optionally select workloads and components to install](../../install/install-visual-studio.md). Workloads and components may leverage third-party software, and they may enable connected experiences, depending on their functionality. For example, [downloading the Azure development workload allows you to publish your cloud apps to Azure](https://visualstudio.microsoft.com/vs/features/azure/). Based on your installation selections, you may also use the Tools and Options menu to connect to, to configure, and to use connected experiences. For example, you can connect to a server, add Azure Services authentication, or change IntelliCode or LiveShare settings.  
 

docs/ide/reference/connected-experiences.md

@@ -5,7 +5,7 @@ description: A list of released versions and build numbers for Visual Studio, so
 author: TerryGLee
 ms.author: tglee
 manager: jmartens
-ms.date: 10/18/2022
+ms.date: 10/25/2022
 ms.custom: vs-acquisition
 ms.topic: reference
 ms.workload:
@@ -26,6 +26,7 @@ The following table lists the build numbers and release dates for Visual Studio
 
 | **Version**| **Channel** | **Release date** | **Build version** |
 | ---------------------- | ----------- | ---------------- | ----------------- |
+| 17.4.0  | Preview 5 | October 25, 2022 | 17.4.33020.496 |
 | 17.4.0  | Preview 4 | October 18, 2022 | 17.4.33015.44 |
 | 17.4.0  | Preview 3 | October 11, 2022 | 17.4.33006.217 |
 | 17.3.6  | Release | October 11, 2022 | 17.3.32929.385 |