Merge pull request #7641 from TerryGLee/tglee-solproj

more updates to Solutions & Projects topics

Author: v-ccolin

docs/ide/create-new-project.md

@@ -1,8 +1,8 @@
 ---
 title: Create a new project
-description: Learn how to create a new project in Visual Studio, step by step.
-ms.custom: SEO-VS-2020
-ms.date: 03/19/2019
+description: Learn how to create a new project in Visual Studio.
+ms.custom: "SEO-VS-2020, contperf-fy21q2"
+ms.date: 12/17/2020
 ms.topic: how-to
 f1_keywords:
 - vs.newproject
@@ -16,11 +16,13 @@ ms.workload:
 ---
 # Create a new project in Visual Studio
 
+In this article, we'll show you how to quickly create a new project in Visual Studio.
+
 ::: moniker range="vs-2017"
 
 ## Open the New Project dialog
 
-There are multiple ways to create a new project in Visual Studio 2017. On the Start page, you can type in the name of a project template in the **Search project templates** box or choose the **Create new project** link to open the **New Project** dialog box. Aside from the Start page, you can also choose **File** > **New** > **Project** on the menu bar or click the **New Project** button on the toolbar.
+There are multiple ways to create a new project in Visual Studio 2017. On the Start page, you can type in the name of a project template in the **Search project templates** box or select the **Create new project** link to open the **New Project** dialog box. Aside from the Start page, you can also select **File** > **New** > **Project** on the menu bar or click the **New Project** button on the toolbar.
 
 ![Start page and File > New > Project](./media/vside-newproject1.png)
 
@@ -41,7 +43,7 @@ The following image shows the project templates available for Visual C# .NET Cor
 
 ## Configure your project
 
-Enter a name for the new project in the **Name** box. You can save the project in the default location on your computer or click the **Browse** button to find another location. You can also choose a solution name or add the new project to a Git repository (by choosing **Add to Source Control**).
+Enter a name for the new project in the **Name** box. You can save the project in the default location on your computer or click the **Browse** button to find another location. You can also select a solution name or add the new project to a Git repository (by selecting **Add to Source Control**).
 
 Click **OK** to create the solution and project.
 
@@ -51,9 +53,9 @@ Click **OK** to create the solution and project.
 
 ## Open the Create a new project page
 
-There are multiple ways to create a new project in Visual Studio 2019. When you first open Visual Studio, the start window appears, and from there, you can choose **Create a new project**.
+There are multiple ways to create a new project in Visual Studio 2019. When you first open Visual Studio, the start window appears, and from there, you can select **Create a new project**.
 
-![Create a new project from the start window in VS 2019](media/vs-2019/start-window-create-new-project.png)
+![Create a new project from the start window in Visual Studio 2019](media/vs-2019/start-window-create-new-project.png)
 
 If the Visual Studio development environment is already open, you can create a new project by choosing **File** > **New** > **Project** on the menu bar or by clicking the **New Project** button on the toolbar.
 
@@ -70,30 +72,33 @@ If you're not selecting from the recently used templates, you can filter all ava
 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 may be missing a workload for Visual Studio. To install additional workloads, for example, **Azure Development** or **Mobile Development with .NET**, click the **Install more tools and features** link to open Visual Studio Installer. From there, select the workloads you want to install, and then choose **Modify**. After that, additional project templates will be available to choose from.
+> 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**, click 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.
 >
-> ![Install more tools and features link in VS 2019](media/vs-2019/install-more-tools-features.png)
+> ![Install more tools and features link in Visual Studio 2019](media/vs-2019/install-more-tools-features.png)
 
 Select a template and then click **Next**.
 
 ## Configure your project
 
-The **Configure your new project** page has options to name your project (and solution), choose a disk location, and select a Framework version (if applicable to the template you chose).
+The **Configure your new project** page has options to name your project (and solution), select a disk location, and select a Framework version (if applicable to the template you chose).
 
-![Configure your new project page in VS 2019](media/vs-2019/configure-new-project.png)
+![Configure your new project page in Visual Studio 2019](media/vs-2019/configure-new-project.png)
 
 > [!NOTE]
 > If you create a new project when you already have a project or solution open in Visual Studio, an extra configuration option is available. You can choose to create a new solution or add the new project to the solution that's already open.
 >
-> ![Create new solution or add to existing solution in VS 2019](media/vs-2019/configure-new-project-solution.png)
+> ![Create new solution or add to existing solution in Visual Studio 2019](media/vs-2019/configure-new-project-solution.png)
 
 Click **Create** to create the new project.
 
 ::: moniker-end
 
 ## Add additional projects to a solution
 
-If you want to add an additional project to a solution, right-click the solution node in **Solution Explorer** and choose **Add** > **New Project**.
+If you want to add an additional project to a solution, right-click the solution node in **Solution Explorer** and 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
 

docs/ide/creating-solutions-and-projects.md

@@ -1,7 +1,7 @@
 ---
 title: Work with solutions and projects
 description: Learn about the difference between solutions and projects and how to use them in Visual Studio.
-ms.custom: SEO-VS-2020
+ms.custom: "SEO-VS-2020, contperf-fy21q2"
 ms.date: 02/06/2018
 ms.topic: how-to
 f1_keywords:
@@ -42,26 +42,26 @@ For information about creating a new project from a template, see [Create a new
 
 If you have a collection of code source files, you can easily add them to a project.
 
-1. On the menu, choose **File** > **New** > **Project From Existing Code**.
+1. On the menu, select **File** > **New** > **Project From Existing Code**.
 
-1. In the **Create Project from Existing Code Files** wizard, choose the project type you want in the **What type of project would you like to create?** drop-down list box, and then choose the **Next** button.
+1. In the **Create Project from Existing Code Files** wizard, select the project type you want in the **What type of project would you like to create?** drop-down list box, and then select the **Next** button.
 
-1. In the wizard, browse to the location of the files and then enter a name for the new project in the **Name** box. When you are done, choose the **Finish** button.
+1. In the wizard, browse to the location of the files and then enter a name for the new project in the **Name** box. When you are done, select the **Finish** button.
 
 > [!NOTE]
 > This option works best for a relatively simple collection of files. Currently, only C++, Apache Cordova, Visual Basic, and C# project types are supported.
 
 ## Add files to a solution
 
-If you have a file that applies to multiple projects, such as a readme file for the solution, or other files that logically belong at the solution level rather than under a specific project, then you can add them to the solution itself. To add an item to a solution, on the context (right-click) menu of the solution node in **Solution Explorer**, choose **Add** > **New Item**, or **Add** > **Existing Item**.
+If you have a file that applies to multiple projects, such as a readme file for the solution, or other files that logically belong at the solution level rather than under a specific project, then you can add them to the solution itself. To add an item to a solution, on the context (right-click) menu of the solution node in **Solution Explorer**, select **Add** > **New Item**, or **Add** > **Existing Item**.
 
 ## Create a .NET project that targets a specific version of the .NET Framework
 
 When you create a .NET Framework project, you can specify a specific version of the .NET Framework that you want the project to use. (When you create a .NET Core project, you don't specify a framework version.)
 
 ::: moniker range="vs-2017"
 
-To specify a .NET Framework version, choose the **Framework** drop-down menu in the **New Project** dialog box.
+To specify a .NET Framework version, select the **Framework** drop-down menu in the **New Project** dialog box.
 
 ![Framework drop-down in New Project dialog](./media/vside-newproject-framework.png)
 
@@ -72,7 +72,7 @@ To specify a .NET Framework version, choose the **Framework** drop-down menu in
 
 ::: moniker range=">=vs-2019"
 
-To specify a .NET Framework version, choose the **Framework** drop-down menu on the **Create a new project** page.
+To specify a .NET Framework version, select the **Framework** drop-down menu on the **Create a new project** page.
 
 ![Framework selector in configure new project](media/vs-2019/configure-new-project-framework.png)
 
@@ -84,15 +84,15 @@ You can also create empty solutions that have no projects. This might be prefera
 
 ### To create an empty solution
 
-1. On the menu bar, choose **File** > **New** > **Project**.
+1. On the menu bar, select **File** > **New** > **Project**.
 
 ::: moniker range="vs-2017"
 
-2. In the left (**Templates**) pane, choose **Other Project Types** > **Visual Studio Solutions** in the expanded list.
+2. In the left (**Templates**) pane, select **Other Project Types** > **Visual Studio Solutions** in the expanded list.
 
-3. In the middle pane, choose **Blank Solution**.
+3. In the middle pane, select **Blank Solution**.
 
-4. Enter **Name** and **Location** values for your solution, and then choose **OK**.
+4. Enter **Name** and **Location** values for your solution, and then select **OK**.
 
 ::: moniker-end
 
@@ -102,7 +102,7 @@ You can also create empty solutions that have no projects. This might be prefera
 
 3. Select the **Blank Solution** template, and then click **Next**.
 
-4. Enter **Name** and **Location** values for your solution, and then choose **Create**.
+4. Enter **Name** and **Location** values for your solution, and then select **Create**.
 
 ::: moniker-end
 
@@ -131,11 +131,11 @@ You can delete solutions and their contents permanently, but not by using the Vi
 
 ### Permanently delete a solution
 
-1. In **Solution Explorer**, on the right-click menu (context menu) of the solution you want to delete, choose **Open folder in File Explorer**.
+1. In **Solution Explorer**, on the right-click menu (context menu) of the solution you want to delete, select **Open folder in File Explorer**.
 
 1. In File Explorer, navigate up one level.
 
-1. Choose the folder containing the solution and then press the **Delete** key.
+1. Select the folder containing the solution and then press the **Delete** key.
 
 ## See also
 

docs/ide/solutions-and-projects-in-visual-studio.md

@@ -1,8 +1,8 @@
 ---
 title: Learn about solutions and projects
 description: Learn about Visual Studio projects and solutions, how to create new projects from a template, and how to view & manage projects in Solution Explorer.
-ms.custom: SEO-VS-2020
-ms.date: 12/15/2020
+ms.custom: "SEO-VS-2020, contperf-fy21q2"
+ms.date: 12/17/2020
 ms.topic: conceptual
 f1_keywords:
 - vs.addnewitem
@@ -71,11 +71,14 @@ You can also create a custom project template that you can use to create new pro
 
 When you create a new project, Visual Studio saves it to its default location, *%USERPROFILE%\source\repos*. To change this location, go to **Tools** > **Options** > **Projects and Solutions** > **Locations**. For more information, see [Options dialog box: Projects and Solutions > Locations](./reference/projects-solutions-locations-options.md).
 
+> [!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).
+
 ## Solution Explorer
 
 After you create a new project, you can use **Solution Explorer** to view and manage the project and solution and their associated items. The following illustration shows **Solution Explorer** with a C# solution that contains two projects:
 
-![Solution Explorer](../ide/media/vs2015_solution_explorer.png)
+![Screenshot of Solution Explorer.](../ide/media/vs2015_solution_explorer.png)
 
 Many menu commands are available from the right-click menu on various items in **Solution Explorer**. These commands include building a project, managing NuGet packages, adding a reference, renaming a file, and running tests, just to name a few. The toolbar across the top of **Solution Explorer** has buttons to switch from a solution view to a folder view, show hidden files, collapse all nodes, and more.