Merge pull request #4407 from MicrosoftDocs/master637104961897810471

ghogen · web-flow · commit 97ff6d7cec2a · 2019-11-27T16:03:35.000-08:00
For protected CLA branch, push strategy should use PR and merge to target branch method to work around git push error
diff --git a/docs/install/modify-visual-studio.md b/docs/install/modify-visual-studio.md
@@ -40,7 +40,17 @@ Here's how.
 
 ## Modify workloads
 
- [Workloads](https://visualstudio.microsoft.com/vs/visual-studio-workloads/) contain the features you need for the programming language or platform that you're using. Use workloads to modify Visual Studio so that it supports the work you want to do, when you want to do it.
+::: moniker range="vs-2017"
+
+ [Workloads](https://visualstudio.microsoft.com/vs/support/selecting-workloads-visual-studio-2017/) contain the features you need for the programming language or platform that you're using. Use workloads to modify Visual Studio so that it supports the work you want to do, when you want to do it.
+
+::: moniker-end
+
+::: moniker range="vs-2019"
+
+ Workloads contain the features you need for the programming language or platform that you're using. Use workloads to modify Visual Studio so that it supports the work you want to do, when you want to do it.
+
+::: moniker-end
 
 >[!NOTE]
 > The following procedure assumes that you have an internet connection.
@@ -113,13 +123,12 @@ Here's how.
 
 ## Modify individual components
 
-If you don't want to install [workloads](https://visualstudio.microsoft.com/vs/visual-studio-workloads/) to customize your Visual Studio installation, choose the **Individual Components** tab from the Visual Studio Installer, select what you want, and then follow the prompts.
+If you don't want to install workloads to customize your Visual Studio installation, choose the **Individual Components** tab from the Visual Studio Installer, select what you want, and then follow the prompts.
 
 [!INCLUDE[install_get_support_md](includes/install_get_support_md.md)]
 
 ## See also
 
-* [Learn more about Visual Studio workloads](https://visualstudio.microsoft.com/vs/visual-studio-workloads/)
 * [List of Visual Studio workload & component IDs](workload-and-component-ids.md)
 * [Update Visual Studio](update-visual-studio.md)
 * [Update a network-based installation of Visual Studio](update-a-network-installation-of-visual-studio.md)
diff --git a/docs/vsto/includes/new-project-dialog-search-md.md b/docs/vsto/includes/new-project-dialog-search-md.md
@@ -0,0 +1,3 @@
+> [!NOTE]
+> You can also search for templates by typing the name of the Office product in the Search text box at the top of the **Create a New Project** dialog. For example, typing **Excel** will show you all of the project templates for Excel.
+You can also filter the list of templates to show only the templates for Office by selecting **Office** in the Project type dropdown box.  For more information see  [Create a new project in Visual Studio](../../ide/create-new-project.md).
diff --git a/docs/vsto/walkthrough-creating-your-first-document-level-customization-for-excel.md b/docs/vsto/walkthrough-creating-your-first-document-level-customization-for-excel.md
@@ -16,6 +16,7 @@ ms.workload:
   - "office"
 ---
 # Walkthrough: Create your first document-level customization for Excel
+
   This introductory walkthrough shows you how to create a document-level customization for Microsoft Office Excel. The features that you create in this kind of solution are available only when a specific workbook is open. You cannot use a document-level customization to make application-wide changes, for example, displaying a new Ribbon tab when any workbook is open.
 
  [!INCLUDE[appliesto_xlalldoc](../vsto/includes/appliesto-xlalldoc-md.md)]
@@ -35,6 +36,7 @@ ms.workload:
   [!INCLUDE[note_settings_general](../sharepoint/includes/note-settings-general-md.md)]
 
 ## Prerequisites
+
  You need the following components to complete this walkthrough:
 
 - [!INCLUDE[vsto_vsprereq](../vsto/includes/vsto-vsprereq-md.md)]
@@ -48,21 +50,30 @@ ms.workload:
 1. Start [!INCLUDE[vsprvs](../sharepoint/includes/vsprvs-md.md)].
 
 2. On the **File** menu, point to **New**, and then click **Project**.
-
+::: moniker range="vs-2017"
 3. In the templates pane, expand **Visual C#** or **Visual Basic**, and then expand **Office/SharePoint**.
 
-4. Under the expanded **Office/SharePoint** node, select the **Office Add-ins** node.
+4. Under the expanded **Office/SharePoint** node, select the **VSTO Add-ins** node.
 
-5. In the list of project templates, choose an Excel VSTO Add-in project.
+5. In the list of project templates, choose an Excel VSTO Workbook project.
 
 6. In the **Name** box, type **FirstWorkbookCustomization**.
 
 7. Click **OK**.
 
-    The **Visual Studio Tools for Office Project Wizard** opens.
+8. Select **Create a new document** from the **Visual Studio Tools for Office Project Wizard**, and click **OK**.
+::: moniker-end
+::: moniker range=">=vs-2019"
+3. On the **Create a New Project** dialog select the **Excel VSTO Workbook** project.
 
-8. Select **Create a new document**, and click **OK**.
+     [!INCLUDE[new-project-dialog-search](../vsto/includes/new-project-dialog-search-md.md)]
 
+4. Click **Next**.
+
+5. Type **FirstWorkbookCustomization** in the **Name** box on the **Configure your new project** dialog and click **Create**.
+
+6. Select **Create a new document** from the **Visual Studio Tools for Office Project Wizard**, and click **OK**.
+::: moniker-end
    - [!INCLUDE[vsprvs](../sharepoint/includes/vsprvs-md.md)] creates the **FirstWorkbookCustomization** project, and adds the following files to the project.
 
    - *FirstWorkbookCustomization*.xlsx - Represents the Excel workbook in the project. Contains all the worksheets and charts.
@@ -78,6 +89,7 @@ ms.workload:
      The Sheet1 code file is opened automatically in the designer.
 
 ## Close and reopen worksheets in the designer
+
  If you deliberately or accidentally close a workbook or a worksheet in the designer while you are developing your project, you can reopen it.
 
 ### To close and reopen a worksheet in the designer
@@ -91,6 +103,7 @@ ms.workload:
      In **Solution Explorer**, double-click the **Sheet1** code file.
 
 ## Add text to a worksheet in the designer
+
  You can design the user interface (UI) of your customization by modifying the worksheet that is open in the designer. For example, you can add text to cells, apply formulas, or add Excel controls. For more information about how to use the designer, see [Office projects in the Visual Studio environment](../vsto/office-projects-in-the-visual-studio-environment.md).
 
 ### To add text to a worksheet by using the designer
@@ -103,6 +116,7 @@ ms.workload:
 > If you add this line of text to cell **A2**, it will be overwritten by other code in this example.
 
 ## Add text to a worksheet programmatically
+
  Next, add code to the Sheet1 code file. The new code uses the object model of Excel to add a second line of text to the workbook. By default, the Sheet1 code file contains the following generated code:
 
 - A partial definition of the `Sheet1` class, which represents the programming model of the worksheet and provides access to the object model of Excel. For more information, [Worksheet host item](../vsto/worksheet-host-item.md) and [Word object model overview](../vsto/word-object-model-overview.md). The remainder of the `Sheet1` class is defined in a hidden code file that you should not modify.
@@ -137,13 +151,15 @@ ms.workload:
 3. Close the workbook.
 
 ## Clean up the project
+
  When you finish developing a project, you should remove the files in the build output folder and the security settings created by the build process.
 
 ### To clean up the completed project on your development computer
 
 1. In Visual Studio, on the **Build** menu, click **Clean Solution**.
 
 ## Next steps
+
  Now that you have created a basic document-level customization for Excel, you can learn more about how to develop customizations from these topics:
 
 - General programming tasks that you can perform in document-level customizations: [Program document-level customizations](../vsto/programming-document-level-customizations.md).
@@ -161,6 +177,7 @@ ms.workload:
 - Deploying document-level customizations for Excel: [Deploy an Office solution](../vsto/deploying-an-office-solution.md).
 
 ## See also
+
 - [Office solutions development overview &#40;VSTO&#41;](../vsto/office-solutions-development-overview-vsto.md)
 - [Excel solutions](../vsto/excel-solutions.md)
 - [Program document-level customizations](../vsto/programming-document-level-customizations.md)
diff --git a/docs/vsto/walkthrough-creating-your-first-document-level-customization-for-word.md b/docs/vsto/walkthrough-creating-your-first-document-level-customization-for-word.md
@@ -16,6 +16,7 @@ ms.workload:
   - "office"
 ---
 # Walkthrough: Create your first document-level customization for Word
+
   This introductory walkthrough shows you how to create a document-level customization for Microsoft Office Word. The features that you create in this kind of solution are available only when a specific document is open. You cannot use a document-level customization to make application-wide changes, for example, displaying a new Ribbon tab when any document is open.
 
  [!INCLUDE[appliesto_wdalldoc](../vsto/includes/appliesto-wdalldoc-md.md)]
@@ -35,6 +36,7 @@ ms.workload:
   [!INCLUDE[note_settings_general](../sharepoint/includes/note-settings-general-md.md)]
 
 ## Prerequisites
+
  You need the following components to complete this walkthrough:
 
 - [!INCLUDE[vsto_vsprereq](../vsto/includes/vsto-vsprereq-md.md)]
@@ -48,24 +50,34 @@ ms.workload:
 1. Start [!INCLUDE[vsprvs](../sharepoint/includes/vsprvs-md.md)].
 
 2. On the **File** menu, point to **New**, and then click **Project**.
-
+::: moniker range="vs-2017"
 3. In the templates pane, expand **Visual C#** or **Visual Basic**, and then expand **Office/SharePoint**.
 
-4. Under the expanded **Office/SharePoint** node, select the **Office Add-ins** node.
+4. Under the expanded **Office/SharePoint** node, select the **VSTO Add-ins** node.
 
-5. In the list of project templates, select a Word VSTO document project .
+5. In the list of project templates, select a Word VSTO document project.
 
 6. In the **Name** box, type **FirstDocumentCustomization**.
 
 7. Click **OK**.
 
-     The **Visual Studio Tools for Office Project Wizard** opens.
+8. Select **Create a new document** from the **Visual Studio Tools for Office Project Wizard**, and click **OK**.
+::: moniker-end
+::: moniker range=">=vs-2019"
+3. On the **Create a New Project** dialog select the **Word VSTO Document** project.
 
-8. Select **Create a new document**, and click **OK**.
+     [!INCLUDE[new-project-dialog-search](../vsto/includes/new-project-dialog-search-md.md)]
 
-     [!INCLUDE[vsprvs](../sharepoint/includes/vsprvs-md.md)] creates the **FirstDocumentCustomization** project, and adds the **FirstDocumentCustomization** document and ThisDocument code file to the project. The **FirstDocumentCustomization** document is opened automatically in the designer.
+4. Click **Next**.
+
+5. Type **FirstWorkbookCustomization** in the **Name** box on the **Configure your new project** dialog and click **Create**.
+
+6. Select **Create a new document** from the **Visual Studio Tools for Office Project Wizard**, and click **OK**.
+::: moniker-end
+   - [!INCLUDE[vsprvs](../sharepoint/includes/vsprvs-md.md)] creates the **FirstDocumentCustomization** project, and adds the **FirstDocumentCustomization** document and ThisDocument code file to the project. The **FirstDocumentCustomization** document is opened automatically in the designer.
 
 ## Close and reopen the document in the designer
+
  If you deliberately or accidentally close the document in the designer while you are developing your project, you can reopen it.
 
 ### To close and reopen the document in the designer
@@ -79,6 +91,7 @@ ms.workload:
      In **Solution Explorer**, double-click the **ThisDocument** code file.
 
 ## Add text to the document in the designer
+
  You can design the user interface (UI) of your customization by modifying the document that is open in the designer. For example, you can add text, tables, or Word controls. For more information about how to use the designer, see [Office projects in the Visual Studio environment](../vsto/office-projects-in-the-visual-studio-environment.md).
 
 ### To add text to your document by using the designer
@@ -88,6 +101,7 @@ ms.workload:
      **This text was added by using the designer.**
 
 ## Add text to the document programmatically
+
  Next, add code to the ThisDocument code file. The new code uses the object model of Word to add a second paragraph of text to the document. By default, the ThisDocument code file contains the following generated code:
 
 - A partial definition of the `ThisDocument` class, which represents the programming model of the document and provides access to the object model of Word. For more information, see [Document host item](../vsto/document-host-item.md) and [Word object model overview](../vsto/word-object-model-overview.md). The remainder of the `ThisDocument` class is defined in a hidden code file that you should not modify.
@@ -125,13 +139,15 @@ ms.workload:
 3. Close the document.
 
 ## Clean up the project
+
  When you finish developing a project, you should remove the files in the build output folder and the security settings created by the build process.
 
 ### To clean up the completed project on your development computer
 
 1. In Visual Studio, on the **Build** menu, click **Clean Solution**.
 
 ## Next steps
+
  Now that you have created a basic document-level customization for Word, you can learn more about how to develop customizations from these topics:
 
 - General programming tasks that you can perform in document-level customizations: [Program document-level customizations](../vsto/programming-document-level-customizations.md).
@@ -149,6 +165,7 @@ ms.workload:
 - Deploying document-level customizations for Word: [Deploy an Office solution](../vsto/deploying-an-office-solution.md).
 
 ## See also
+
 - [Office solutions development overview &#40;VSTO&#41;](../vsto/office-solutions-development-overview-vsto.md)
 - [Word solutions](../vsto/word-solutions.md)
 - [Program document-level customizations](../vsto/programming-document-level-customizations.md)

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+> [!NOTE]`
	`2`	`+> You can also search for templates by typing the name of the Office product in the Search text box at the top of the Create a New Project dialog. For example, typing Excel will show you all of the project templates for Excel.`
	`3`	`+You can also filter the list of templates to show only the templates for Office by selecting Office in the Project type dropdown box. For more information see [Create a new project in Visual Studio](../../ide/create-new-project.md).`