Merge pull request #4799 from MicrosoftDocs/master637173218110955844

For protected CLA branch, push strategy should use PR and merge to target branch method to work around git push error

Author: ghogen

docs/debugger/debugging-absolute-beginners.md

@@ -1,7 +1,7 @@
 ---
 title: "Debugging code for absolute beginners"
 description: "If you are debugging for the first time, learn a few principles to help you run your app in debugging mode with Visual Studio"
-ms.date: 07/06/2018
+ms.date: 02/14/2020
 ms.topic: tutorial
 helpviewer_keywords:
   - "debugger"
@@ -79,13 +79,13 @@ Next, we will create an application that has a few bugs.
 1. Open Visual Studio.
 
     ::: moniker range=">=vs-2019"
-    On the start window, choose **Create a new project**. Type **console** in the search box and then choose **Console App (.NET Framework)** or **Console App (.NET Core)**. Choose **Next**. Type a project name like **ConsoleApp-FirstApp** and click **Create**.
+    On the start window, choose **Create a new project**. Type **console** in the search box and then choose either **Console App (.NET Core)** or **Console App (.NET Framework)**. Choose **Next**. Type a project name like **ConsoleApp-FirstApp** and click **Create**.
     ::: moniker-end
     ::: moniker range="vs-2017"
     From the top menu bar, choose **File** > **New** > **Project**. In the left pane of the **New project** dialog box, under **Visual C#**, choose **Console App**, and then in the middle pane choose either **Console App (.NET Framework)** or **Console App (.NET Core)**. Type a name like **ConsoleApp-FirstApp** and click **OK**.
     ::: moniker-end
 
-    If you don't see the **Console App (.NET Framework)** or **Console App (.NET Core)** project template, go to **Tools** > **Get Tools and Features**, which opens the Visual Studio Installer. Choose the **.NET desktop development** workload or the **.NET Core cross platform development** workload, then choose **Modify**.
+    If you don't see the **Console App (.NET Framework)** or **Console App (.NET Core)** project template, go to **Tools** > **Get Tools and Features**, which opens the Visual Studio Installer. Choose either the **.NET Core cross platform development** or the **.NET desktop development** workload, then choose **Modify**.
 
     Visual Studio creates the console project, which appears in Solution Explorer in the right pane.
 

docs/debugger/get-started-debugging-multithreaded-apps.md

@@ -2,7 +2,7 @@
 title: "Learn to debug multithreaded applications"
 description: Debug using the Parallel Stacks and Parallel Watch windows in Visual Studio
 ms.custom: ""
-ms.date: "11/16/2018"
+ms.date: "02/14/2020"
 ms.topic: "conceptual"
 dev_langs:
   - "CSharp"

docs/debugger/how-to-debug-managed-and-native-code.md

@@ -49,7 +49,7 @@ If you have Visual Studio installed, but don't have the workloads you need, sele
 1. Open Visual Studio and create a project.
 
     ::: moniker range=">=vs-2019"
-    Press **Esc** to close the start window. Type **Ctrl + Q** to open the search box, type **Empty Project**, choose **Templates**, then choose **Create new Empty Project project** for C++. In the dialog box that appears, choose **Create**. Then, type a name like **Mixed_Mode_Debugging** and click **Create**.
+    Press **Esc** to close the start window. Type **Ctrl + Q** to open the search box, type **Empty Project**, choose **Templates**, then choose **Empty Project** for C++. In the dialog box that appears, choose **Create**. Then, type a name like **Mixed_Mode_Debugging** and click **Create**.
     ::: moniker-end
     ::: moniker range="vs-2017"
     From the top menu bar, choose **File** > **New** > **Project**. In the left pane of the **New project** dialog box, under **Visual C++**, choose **Other**, and then in the middle pane choose **Empty Project**. Then, type a name like **Mixed_Mode_Debugging** and click **OK**.
@@ -59,12 +59,6 @@ If you have Visual Studio installed, but don't have the workloads you need, sele
 
     Visual Studio creates the project.
 
-1. In the **New Project** dialog box, under **Visual C++**, select **Other**, and then select **Empty Project** in the middle pane.
-
-1. In the **Name** field, type **Mixed_Mode_Debugging**, and then select **OK**.
-
-   Visual Studio creates the empty project and displays it in **Solution Explorer**.
-
 1. In **Solution Explorer**, select **Source Files**, and then select **Project** > **Add New Item**. Or, right-click **Source Files** and select **Add** > **New Item**.
 
 1. In the **New Item** dialog, select **C++ file (.cpp)**. Type **Mixed_Mode.cpp** in the **Name** field, and then select **Add**.
@@ -126,7 +120,7 @@ If you have Visual Studio installed, but don't have the workloads you need, sele
 1. Open Visual Studio and create a new project.
 
     ::: moniker range=">=vs-2019"
-    Press **Esc** to close the start window. Type **Ctrl + Q** to open the search box, type **console**, choose **Templates**, and then choose **Create new Console App (.NET Framework) project** for C#. In the dialog box that appears, choose **Create**.
+    Press **Esc** to close the start window. Type **Ctrl + Q** to open the search box, type **console**, choose **Templates**, and then choose **Console App (.NET Core)** or **Console App (.NET Framework)** for C#. In the dialog box that appears, choose **Create**.
 
     Then, type a name like **Mixed_Mode_Calling_App** and click **Create**.
     ::: moniker-end

docs/debugger/how-to-use-the-threads-window.md

@@ -1,7 +1,7 @@
 ---
 title: "Debug a multithreaded app"
 description: Debug using the Threads window and the Debug Location toolbar in Visual Studio
-ms.date: "11/21/2018"
+ms.date: "02/14/2020"
 ms.topic: "conceptual"
 dev_langs:
   - "CSharp"
@@ -30,25 +30,36 @@ Create the following multithreaded app project to use in this tutorial:
 
 1. Open Visual Studio and create a new project.
 
-    ::: moniker range=">=vs-2019"
-    Press **Esc** to close the start window. Type **Ctrl + Q** to open the search box, type **console** (or **c++**), choose **Templates**, and then:
+   ::: moniker range=">=vs-2019"
 
-    - For C#, choose **Create new Console App (.NET Framework) project** for C#. In the dialog box that appears, choose **Create**.
-    - For C++, choose **Create new Console App project**. In the dialog box that appears, choose **Create**.
+   If the start window is not open, choose **File** > **Start Window**.
 
-    Then, type a name like **MyThreadWalkthroughApp** and click **Create**.
-    ::: moniker-end
-    ::: moniker range="vs-2017"
-    From the top menu bar, choose **File** > **New** > **Project**. In the left pane of the **New project** dialog box, choose the following:
-    - For a C# app, under **Visual C#**, choose **Windows Desktop**, and then in the middle pane choose **Console App (.NET Framework)**.
-    - For a C++ app, under **Visual C++**, choose **Windows Desktop**,, and then choose **Windows Console Application**.
+   On the start window, choose **Create a new project**.
 
-    Then, type a name like **MyThreadWalkthroughApp** and click **OK**.
-    ::: moniker-end
+   On the **Create a new project** window, enter or type *console* in the search box. Next, choose **C#** or **C++** from the Language list, and then choose **Windows** from the Platform list. 
 
-    If you don't see the **Console App** project template, go to **Tools** > **Get Tools and Features...**, which opens the Visual Studio Installer. Choose the **.NET desktop development** or **Desktop development with C++** workload, then choose **Modify**.
+   After you apply the language and platform filters, choose the **Console App (.NET Core)** or, for C++, **Console App** template, and then choose **Next**.
 
-    The new project appears in **Solution Explorer**, and a source file called *Program.cs* or *MyThreadWalkthroughApp.cpp* opens in the source code window.
+   > [!NOTE]
+   > If you don't see the correct template, go to **Tools** > **Get Tools and Features...**, which opens the Visual Studio Installer. Choose the **.NET desktop development** or **Desktop development with C++** workload, then choose **Modify**.
+
+   In the **Configure your new project** window, type or enter *MyThreadWalkthroughApp* in the **Project name** box. Then, choose **Create**.
+
+   ::: moniker-end
+   ::: moniker range="vs-2017"
+   From the top menu bar, choose **File** > **New** > **Project**. In the left pane of the **New project** dialog box, choose the following:
+
+   - For a C# app, under **Visual C#**, choose **Windows Desktop**, and then in the middle pane choose **Console App (.NET Framework)**.
+   - For a C++ app, under **Visual C++**, choose **Windows Desktop**,, and then choose **Windows Console Application**.
+
+   If you don't see the **Console App (.NET Core)** or, for C++, the **Console App** project template, go to **Tools** > **Get Tools and Features...**, which opens the Visual Studio Installer. Choose the **.NET desktop development** or **Desktop development with C++** workload, then choose **Modify**.
+
+   Then, type a name like *MyThreadWalkthroughApp* and click **OK**.
+
+   Select **OK**.
+   ::: moniker-end
+
+   A new console project appears. After the project has been created, a source file appears. Depending on the language you have chosen, the source file might be called *Program.cs*, *MyThreadWalkthroughApp.cpp*, or *Module1.vb*.
 
 1. Replace the code in the source file with the C# or C++ example code from [Get started debugging multithreaded apps](../debugger/get-started-debugging-multithreaded-apps.md).
 

docs/debugger/toc.yml

@@ -16,7 +16,7 @@
     href: quickstart-debug-with-managed.md
   - name: Debug a C++ app
     href: quickstart-debug-with-cplusplus.md
-  - name: Debug an ASP.NET app
+  - name: Debug an ASP.NET Core app
     href: quickstart-debug-aspnet.md
 - name: Tutorials
   items:

docs/debugger/walkthrough-debugging-a-parallel-application.md

@@ -1,7 +1,7 @@
 ---
 title: "Debug a parallel application | Microsoft Docs"
 description: Debug using the Parallel Tasks and Parallel Stacks windows in Visual Studio
-ms.date: "03/22/2018"
+ms.date: "02/14/2020"
 ms.topic: "conceptual"
 dev_langs:
   - "CSharp"
@@ -58,25 +58,37 @@ This walkthrough shows how to use the **Parallel Tasks** and **Parallel Stacks**
 
 1. Open Visual Studio and create a new project.
 
-    ::: moniker range=">=vs-2019"
-    Press **Esc** to close the start window. Type **Ctrl + Q** to open the search box, type **console** (or **c++**), choose **Templates**, and then:
+   ::: moniker range=">=vs-2019"
 
-    - For C# or Visual Basic, choose **Create new Console App (.NET Framework) project** for either C# or Visual Basic. In the dialog box that appears, choose **Create**.
-    - For C++, choose **Create new Console App project** for C++. In the dialog box that appears, choose **Create**.
+   If the start window is not open, choose **File** > **Start Window**.
 
-    Then, type a name or use the default name and click **Create**.
-    ::: moniker-end
-    ::: moniker range="vs-2017"
-    From the top menu bar, choose **File** > **New** > **Project**. In the left pane of the **New project** dialog box, choose the following:
+   On the start window, choose **Create a new project**.
 
-    - For a C# app, under **Visual C#**, choose **Windows Desktop**, and then in the middle pane choose **Console App (.NET Framework)**.
-    - For a Visual Basic app, under **Visual Basic**, choose **Windows Desktop**, and then in the middle pane choose **Console App (.NET Framework)**.
-    - For a C++ app, under **Visual C++**, choose **Windows Desktop**,, and then choose **Windows Console Application**.
+   On the **Create a new project** window, enter or type *console* in the search box. Next, choose **C#**, **C++**, or **Visual Basic** from the Language list, and then choose **Windows** from the Platform list. 
 
-    Then, type a name or use the default name and click **OK**.
-    ::: moniker-end
+   After you apply the language and platform filters, choose the **Console App (.NET Core)** or, for C++, **Console App** template, and then choose **Next**.
 
-    If you don't see the **Console App** project template, go to **Tools** > **Get Tools and Features...**, which opens the Visual Studio Installer. Choose the **.NET desktop development** or **Desktop development with C++** workload, then choose **Modify**.
+   > [!NOTE]
+   > If you don't see the correct template, go to **Tools** > **Get Tools and Features...**, which opens the Visual Studio Installer. Choose the **.NET desktop development** or **Desktop development with C++** workload, then choose **Modify**.
+
+   In the **Configure your new project** window, type a name or use the default name in the **Project name** box. Then, choose **Create**.
+
+   ::: moniker-end
+   ::: moniker range="vs-2017"
+   From the top menu bar, choose **File** > **New** > **Project**. In the left pane of the **New project** dialog box, choose the following:
+
+   - For a C# app, under **Visual C#**, choose **Windows Desktop**, and then in the middle pane choose **Console App (.NET Framework)**.
+   - For a Visual Basic app, under **Visual Basic**, choose **Windows Desktop**, and then in the middle pane choose **Console App (.NET Framework)**.
+   - For a C++ app, under **Visual C++**, choose **Windows Desktop**,, and then choose **Windows Console Application**.
+
+   If you don't see the **Console App (.NET Core)** or, for C++, the **Console App** project template, go to **Tools** > **Get Tools and Features...**, which opens the Visual Studio Installer. Choose the **.NET desktop development** or **Desktop development with C++** workload, then choose **Modify**.
+
+   Then, type a name or use the default name and click **OK**.
+
+   Select **OK**.
+   ::: moniker-end
+
+   A new console project appears. After the project has been created, a source file appears.
 
 1. Open the .cpp, .cs, or .vb code file in the project. Delete its contents to create an empty code file.
 

docs/debugger/write-better-code-with-visual-studio.md

@@ -2,7 +2,7 @@
 title: Debugging techniques and tools
 description: "Write better code with less bugs by using Visual Studio to fix exceptions, fix errors, and improve your code"
 ms.custom: ['debug-experiment', 'seodec18']
-ms.date: "01/24/2019"
+ms.date: "02/14/2020"
 ms.topic: "conceptual"
 helpviewer_keywords:
   - "debugger"
@@ -34,14 +34,26 @@ The following code has some bugs that you can fix using the Visual Studio IDE. T
 
 To create the app:
 
-1. Open Visual Studio and choose **File** > **New** > **Project**. Under **Visual C#**, choose **Windows Desktop** or **.NET Core**, and then in the middle pane choose a **Console App**.
+1. You must have Visual Studio installed and either the **.NET Core cross platform development** or the **.NET desktop development** workload installed, depending on which app type you want to create.
 
-    > [!NOTE]
-    > If you don't see the **Console Application** project template, click the **Open Visual Studio Installer** link in the left pane of the **New Project** dialog box. The Visual Studio Installer launches. Choose the **.NET desktop development** or **.NET Core cross-platform development** workload, then choose **Modify**.
+    If you haven't already installed Visual Studio, go to the [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/) page to install it for free.
 
-2. In the **Name** field, type **Console_Parse_JSON** and click **OK**. Visual Studio creates the project.
+    If you need to install the workload but already have Visual Studio, click **Tools** > **Get Tools and Features**. The Visual Studio Installer launches. Choose the **.NET Core cross platform development** or **.NET desktop development** workload, then choose **Modify**.
 
-3. Replace the default code in the project's *Program.cs* file with the sample code below.
+1. Open Visual Studio.
+
+    ::: moniker range=">=vs-2019"
+    On the start window, choose **Create a new project**. Type **console** in the search box and then choose either **Console App (.NET Core)** or **Console App (.NET Framework)**. Choose **Next**. Type a project name like **Console_Parse_JSON** and click **Create**.
+    ::: moniker-end
+    ::: moniker range="vs-2017"
+    From the top menu bar, choose **File** > **New** > **Project**. In the left pane of the **New project** dialog box, under **Visual C#**, choose **Console App**, and then in the middle pane choose either **Console App (.NET Core)** or **Console App (.NET Framework)**. Type a name like **Console_Parse_JSON** and click **OK**.
+    ::: moniker-end
+
+    If you don't see the **Console App (.NET Core)** or **Console App (.NET Framework)** project template, go to **Tools** > **Get Tools and Features**, which opens the Visual Studio Installer. Choose either the **.NET Core cross platform development** or the **.NET desktop development** workload, then choose **Modify**.
+
+    Visual Studio creates the console project, which appears in Solution Explorer in the right pane.
+
+1. Replace the default code in the project's *Program.cs* file with the sample code below.
 
 ```csharp
 using System;

docs/ide/report-a-problem-minidumps.md

@@ -34,7 +34,7 @@ In some cases, Microsoft might ask for a minidump of a running Visual Studio pro
 ## Get the call stacks from the minidump
 
 1. Open the dump file in Visual Studio.
-1. Got to **Tools** > **Options** > **Debugging** > **Symbols** and make sure that **Microsoft Symbol Servers** is checked in the **Symbol file (.pdb) locations**.
+1. Go to **Tools** > **Options** > **Debugging** > **Symbols** and make sure that **Microsoft Symbol Servers** is checked in the **Symbol file (.pdb) locations**.
 1. Open the **Command** window (**View** > **Other Windows** > **Command Window**)
 1. Type ‘~*k’. The window displays all threads' call stacks.
 1. Copy all text from Command Window and save to a text file.