Merge pull request #13802 from Mikejo5000/mikejo-br25

Update instructions for creating a new project

Author: prmerger-automator[bot]

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

@@ -1,7 +1,7 @@
 ---
 title: "Tutorial: Debug C# and C++ code (mixed mode)"
 description: Debug a native DLL from a .NET Core or .NET Framework application by using mixed-mode debugging to enable more than one debugger type in a debugging session.
-ms.date: 09/18/2024
+ms.date: 04/07/2025
 ms.topic: tutorial
 dev_langs:
   - "CSharp"
@@ -54,7 +54,13 @@ 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-2022"
+    Press **Esc** to close the start window. Type **Ctrl + Q** to open the search box, type **Empty Project**, and then select the **Empty Project** for C++. In the **Configure your new project** dialog box that appears, type a name like **Mixed_Mode_Debugging** and click **Create**.
+    ::: moniker-end
+
+    ::: 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 **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
 
     If you don't see the **Empty Project** project template, go to **Tools** > **Get Tools and Features...**, which opens the Visual Studio Installer. The Visual Studio Installer launches. Choose the **Desktop development with C++** workload, then choose **Modify**.
 
@@ -124,11 +130,17 @@ 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-2022"
+    Press **Esc** to close the start window. Type **Ctrl + Q** to open the search box, type **console**, and then select the C# **Console App** for .NET or .NET Framework.
+    ::: moniker-end
+
+    ::: 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 **Console App** for .NET Core or **Console App (.NET Framework)** for C#. In the dialog box that appears, choose **Next**.
+    ::: moniker-end
 
     Then, type a name like **Mixed_Mode_Calling_App** and click **Next** or **Create**, whichever option is available.
 
-    For .NET Core, choose either the recommended target framework or .NET 8, and then choose **Create**.
+    For .NET Core or .NET 5+, choose either the recommended target framework or .NET 8, and then choose **Create**.
 
     If you don't see the correct project template, go to **Tools** > **Get Tools and Features...**, which opens the Visual Studio Installer. Choose the correct .NET workload as described in the prerequisites, and then choose **Modify**.
 

docs/debugger/quickstart-debug-with-cplusplus.md

@@ -1,7 +1,7 @@
 ---
 title: Debug C++ code, set breakpoints, inspect variables
 description: Debug native C++ code by using the Visual Studio debugger, create a project, set breakpoints, inspect variables, and edit code while debugging.
-ms.date: 08/06/2018
+ms.date: 04/07/2025
 ms.topic: quickstart
 helpviewer_keywords:
   - "debugger"
@@ -18,7 +18,7 @@ The Visual Studio debugger provides many powerful features to help you debug you
 
 1. Open Visual Studio and create a project.
 
-    On the Welcome Page, select **Create a new project**. Select **Empty Project**. Make sure you are selecting the Project Template for C++.
+    If the Start window isn't already open, select **File > Start Window**. In the Start window, select **Create a new project**. In the search box, type "Empty project", and then select the C++ **Empty Project** template.
 
    If you don't see the project template, open the **Visual Studio Installer**. Choose the **Desktop development with C++ workload**, then choose **Modify**.
 
@@ -35,7 +35,7 @@ The Visual Studio debugger provides many powerful features to help you debug you
     }
     ```
 
-    with this code (do not remove `#include "stdafx.h"`):
+    with this code (don't remove `#include "stdafx.h"`):
 
     ```cpp
     #include <list>
@@ -66,7 +66,7 @@ The Visual Studio debugger provides many powerful features to help you debug you
 
 ## Set a breakpoint
 
-A *breakpoint* is a marker that indicates where Visual Studio should suspend your running code so you can take a look at the values of variables, or the behavior of memory, or whether or not a branch of code is getting run. It is the most basic feature in debugging.
+A *breakpoint* is a marker that indicates where Visual Studio should suspend your running code so you can take a look at the values of variables, or the behavior of memory, or whether or not a branch of code is getting run. It's the most basic feature in debugging.
 
 1. To set the breakpoint, click in the gutter to the left of the `doWork` function call (or select the line of code and press **F9**).
 
@@ -76,7 +76,7 @@ A *breakpoint* is a marker that indicates where Visual Studio should suspend you
 
     ![Hit a breakpoint](../debugger/media/dbg-qs-hit-breakpoint.png "Hit a breakpoint")
 
-    The debugger pauses where you set the breakpoint. The statement where the debugger and app execution is paused is indicated by the yellow arrow. The line with the `doWork` function call has not yet executed.
+    The debugger pauses where you set the breakpoint. The statement where the debugger and app execution is paused is indicated by the yellow arrow. The line with the `doWork` function call hasn't yet executed.
 
     > [!TIP]
     > If you have a breakpoint in a loop or recursion, or if you have many breakpoints that you frequently step through, use a [conditional breakpoint](../debugger/using-breakpoints.md#BKMK_Specify_a_breakpoint_condition_using_a_code_expression) to make sure that your code is suspended ONLY when specific conditions are met. A conditional breakpoint saves time and can also make it easier to debug issues that are hard to reproduce.

docs/debugger/walkthrough-writing-a-visualizer-in-visual-basic.md

@@ -21,7 +21,7 @@ ms.subservice: debug-diagnostics
 > [!IMPORTANT]
 > Starting with Visual Studio 2022 version 17.9, visualizers can now be written in .NET 6.0+ that run out-of-process using the new VisualStudio.Extensibility model. We encourage visualizer authors to reference the new documentation at [Create Visual Studio debugger visualizers](../extensibility/visualstudio.extensibility/debugger-visualizer/debugger-visualizers.md) unless they want to support older versions of Visual Studio or want to ship their custom visualizers as part of a library DLL.
 
-This walkthrough shows how to write a simple visualizer by using Visual Basic. The visualizer you will create in this walkthrough displays the contents of a string using a Windows Forms message box. This simple string visualizer is a basic example to show how you can create visualizers for other data types more applicable to your projects.
+This walkthrough shows how to write a simple visualizer by using Visual Basic. The visualizer you'll create in this walkthrough displays the contents of a string using a Windows Forms message box. This simple string visualizer is a basic example to show how you can create visualizers for other data types more applicable to your projects.
 
 > [!NOTE]
 > The dialog boxes and menu commands you see might differ from those described in Help, depending on your active settings or edition. To change your settings, go to the **Tools** menu and choose **Import and Export** . For more information, see [Reset settings](../ide/personalizing-the-visual-studio-ide.md#reset-all-settings).
@@ -34,7 +34,13 @@ Visualizer code must be placed in a DLL that will be read by the debugger. The f
 
 1. Create a new class library project.
 
-    Press **Esc** to close the start window. Type **Ctrl + Q** to open the search box, type **visual basic**, choose **Templates**, then choose **Create a new Class Library (.NET Framework)**. In the dialog box that appears, choose **Create**.
+    ::: moniker range=">=vs-2022"
+    Press **Esc** to close the start window. Type **Ctrl + Q** to open the search box, type **class library**, and then select the Visual Basic **Class Library (.NET Framework)**.
+    ::: moniker-end
+
+    ::: moniker range="vs-2019"
+    Press **Esc** to close the start window. Type **Ctrl + Q** to open the search box, type **visual basic**, choose **Templates**, then choose **Create a new Class Library (.NET Framework)**.
+    ::: moniker-end
 
 2. Type an appropriate name for the class library, such as `MyFirstVisualizer`, and then click **Create** or **OK**.
 
@@ -64,7 +70,7 @@ Visualizer code must be placed in a DLL that will be read by the debugger. The f
    ```
 
 ## Add the Debugger-side Code
- Now, you are ready to create the debugger-side code. This is the code that runs within the debugger to display the information that you want to visualize. First, you have to change the declaration of the `DebuggerSide` object so that it inherits from the base class `DialogDebuggerVisualizer`.
+ Now, you're ready to create the debugger-side code. This is the code that runs within the debugger to display the information that you want to visualize. First, you have to change the declaration of the `DebuggerSide` object so that it inherits from the base class `DialogDebuggerVisualizer`.
 
 ### To inherit from DialogDebuggerVisualizer
 
@@ -96,7 +102,7 @@ Visualizer code must be placed in a DLL that will be read by the debugger. The f
       End Sub
   ```
 
-  The `Show` method contains the code that actually creates the visualizer dialog box, or other user interface, and displays the information that has been passed to the visualizer from the debugger. You must add the code that creates the dialog box and displays the information. In this walkthrough, you will do this using a Windows Forms message box. First, you must add a reference and `Imports` statement for <xref:System.Windows.Forms>.
+  The `Show` method contains the code that actually creates the visualizer dialog box, or other user interface, and displays the information that has been passed to the visualizer from the debugger. You must add the code that creates the dialog box and displays the information. In this walkthrough, you'll do this using a Windows Forms message box. First, you must add a reference and `Imports` statement for <xref:System.Windows.Forms>.
 
 ### To add System.Windows.Forms
 
@@ -115,7 +121,7 @@ Visualizer code must be placed in a DLL that will be read by the debugger. The f
     ```
 
 ## Create Your Visualizer's User Interface
- Now you will add some code to create and show the user interface for your visualizer. Because this is your first visualizer, you will keep the user interface simple and use a Message Box.
+ Now you'll add some code to create and show the user interface for your visualizer. Because this is your first visualizer, you'll keep the user interface simple and use a Message Box.
 
 ### To show the visualizer output in a dialog box
 
@@ -125,12 +131,12 @@ Visualizer code must be placed in a DLL that will be read by the debugger. The f
     MessageBox.Show(objectProvider.GetObject().ToString())
     ```
 
-     This example code does not include error handling. You should include error handling in a real visualizer, or any other kind of application.
+     This example code doesn't include error handling. You should include error handling in a real visualizer, or any other kind of application.
 
 2. On the **Build** menu, click **Build MyFirstVisualizer**. The project should build successfully. Correct any build errors before continuing.
 
 ## Add the Necessary Attribute
- That is the end of the debugger-side code. There is one more step, however: the attribute that tells the debuggee side which collection of classes comprises the visualizer.
+ That is the end of the debugger-side code. There's one more step, however: the attribute that tells the debuggee side which collection of classes comprises the visualizer.
 
 ### To add the type to visualize for the debuggee-side code
 
@@ -145,7 +151,7 @@ In the debugger-side code, you specify the type to visualize (the object source)
 2. On the **Build** menu, click **Build MyFirstVisualizer**. The project should build successfully. Correct any build errors before continuing.
 
 ## Create a Test Harness
- At this point, your first visualizer is finished. If you have followed the steps correctly, you can build the visualizer and install it into Visual Studio. Before you install a visualizer into Visual Studio, however, you should test it to make sure that it runs correctly. You will now create a test harness to run the visualizer without installing it into Visual Studio.
+ At this point, your first visualizer is finished. If you have followed the steps correctly, you can build the visualizer and install it into Visual Studio. Before you install a visualizer into Visual Studio, however, you should test it to make sure that it runs correctly. you'll now create a test harness to run the visualizer without installing it into Visual Studio.
 
 ### To add a test method to show the visualizer
 
@@ -187,7 +193,7 @@ In the debugger-side code, you specify the type to visualize (the object source)
 6. Click **OK**.
 
 ## Finish Your Test Harness and Test Your Visualizer
- Now, you will add the code to finish the test harness.
+ Now, you'll add the code to finish the test harness.
 
 ### To add code to MyTestConsole
 
@@ -210,7 +216,7 @@ In the debugger-side code, you specify the type to visualize (the object source)
    DebuggerSide.TestShowVisualizer(myString)
    ```
 
-   Now you are ready to test your first visualizer.
+   Now you're ready to test your first visualizer.
 
 ### To test the visualizer