Merge pull request #3782 from MicrosoftDocs/master

1/30/2019 AM Publish

Author: gewarren

.openpublishing.publish.config.json

@@ -110,7 +110,5 @@
      }
     },
   "need_generate_pdf": false,
-  "need_generate_intellisense": false,
-  "enable_branch_build_custom_validation": true,
-  "enable_pull_request_custom_validation": true
+  "need_generate_intellisense": false
 }

docs/extensibility/debugger/attaching-to-the-program.md

@@ -29,7 +29,7 @@ After you have registered your programs with the appropriate port, you must atta
 
    If you run your DE in the same process as the application to be debugged, then you must implement the following methods of [IDebugProgramNode2](../../extensibility/debugger/reference/idebugprogramnode2.md):  
 
-- [GetHostName](../../extensibility/debugger/reference/idebugprogramnode2-gethostname.md),  
+- [GetHostName](../../extensibility/debugger/reference/idebugprogramnode2-gethostname.md)  
 
 - [GetHostPid](../../extensibility/debugger/reference/idebugprogramnode2-gethostpid.md)  
 
@@ -63,4 +63,4 @@ After you have registered your programs with the appropriate port, you must atta
  [GetProgramId](../../extensibility/debugger/reference/idebugprogram2-getprogramid.md)   
  [IDebugProgramEx2](../../extensibility/debugger/reference/idebugprogramex2.md)   
  [Attach](../../extensibility/debugger/reference/idebugprogramex2-attach.md)   
- [Attach](../../extensibility/debugger/reference/idebugengine2-attach.md)
+ [Attach](../../extensibility/debugger/reference/idebugengine2-attach.md)

docs/extensibility/debugger/reference/idebugprogramnode2-gethostpid.md

@@ -41,19 +41,17 @@ int GetHostPid ( 
  The following example shows how to implement this method for a simple `CProgram` object that implements the [IDebugProgramNode2](../../../extensibility/debugger/reference/idebugprogramnode2.md) interface.  
 
 ```cpp  
-HRESULT CProgram::GetHostPid(DWORD* pdwHostPid) {    
-    // Check for valid argument.    
-   if (pdwHostPid)    
-    {    
-        // Get the process identifier of the calling process.    
-      *pdwHostPid = GetCurrentProcessId();    
-  
-        return S_OK;    
-    }    
-  
-    return E_INVALIDARG;    
+HRESULT CProgram::GetHostPid(AD_PROCESS_ID* pdwHostPid) {
+   // Check for valid argument.
+   if (pdwHostPid == NULL)
+     return E_INVALIDARG;
+
+   // Get the process identifier of the calling process.
+   pdwHostPid->ProcessIdType = AD_PROCESS_ID_SYSTEM;
+   pdwHostPid->ProcessId.dwProcessId = GetCurrentProcessId();
+   return S_OK; 
 }    
 ```  
   
 ## See Also  
- [IDebugProgramNode2](../../../extensibility/debugger/reference/idebugprogramnode2.md)
+ [IDebugProgramNode2](../../../extensibility/debugger/reference/idebugprogramnode2.md)

docs/get-started/csharp/tutorial-aspnet-core.md

@@ -26,7 +26,7 @@ In this tutorial for C# development with ASP.NET Core using Visual Studio, you'l
 
 ### Install Visual Studio
 
-If you haven't already installed Visual Studio, go to the [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=button+cta&utm_content=download+vs2017) page to install it for free.
+If you haven't already installed Visual Studio, go to the [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=inline+link&utm_content=download+vs2017) page to install it for free.
 
 ### Update Visual Studio
 

docs/get-started/csharp/tutorial-console.md

@@ -524,7 +524,7 @@ namespace Calculator
 Congratulations on completing this tutorial! To learn even more, continue with the following tutorials.
 
 > [!div class="nextstepaction"]
-> [C# Tutorials](/dotnet/csharp/tutorials/)
+> [Continue with more C# tutorials](/dotnet/csharp/tutorials/)
 
 ## See also
 

docs/get-started/csharp/tutorial-debugger.md

@@ -38,7 +38,7 @@ In this tutorial, you will:
 
 * You must have Visual Studio 2017 installed and the **.NET desktop development** workload.
 
-    If you haven't already installed Visual Studio, go to the [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=button+cta&utm_content=download+vs2017) page to install it for free.
+    If you haven't already installed Visual Studio, go to the [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=inline+link&utm_content=download+vs2017) page to install it for free.
 
     If you need to install the workload but already have Visual Studio, click the **Open Visual Studio Installer** link in the left pane of the **New Project** dialog box (select **File** > **New** > **Project**). The Visual Studio Installer launches. Choose the **.NET desktop development** workload, then choose **Modify**.
 

docs/get-started/csharp/tutorial-editor.md

@@ -19,7 +19,7 @@ ms.workload:
 In this 10-minute introduction to the code editor in Visual Studio, we'll add code to a file to look at some of the ways that Visual Studio makes writing, navigating, and understanding code easier.
 
 > [!TIP]
-> If you haven't already installed Visual Studio, go to the [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=button+cta&utm_content=download+vs2017) page to install it for free.
+> If you haven't already installed Visual Studio, go to the [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=inline+link&utm_content=download+vs2017) page to install it for free.
 
 This article assumes you're already familiar with C#. If you aren't, we suggest you look at a tutorial such as [Get started with C# and ASP.NET Core in Visual Studio](tutorial-aspnet-core.md) first.
 

docs/get-started/csharp/tutorial-projects-solutions.md

@@ -18,7 +18,7 @@ ms.workload:
 In this introductory article, we'll explore what it means to create a *solution* and a *project* in Visual Studio. A solution is a container that's used to organize one or more related code projects, for example a class library project and a corresponding test project. We'll look at the properties of a project and some of the files it can contain. We'll also create a reference from one project to another.
 
 > [!TIP]
-> If you haven't already installed Visual Studio, go to the [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=button+cta&utm_content=download+vs2017) page to install it for free.
+> If you haven't already installed Visual Studio, go to the [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=inline+link&utm_content=download+vs2017) page to install it for free.
 
 We'll construct a solution and project from scratch as an educational exercise to understand the concept of a project. In your general use of Visual Studio, you'll likely use some of the various project *templates* that Visual Studio offers when you create a new project.
 

docs/get-started/csharp/tutorial-uwp.md

@@ -19,7 +19,7 @@ ms.workload:
 
 In this 5-10 minute introduction to the Visual Studio integrated development environment (IDE), you'll create a "Hello World" app that runs on any Windows 10 device. To do so, you'll use a Universal Windows Platform (UWP) project template, Extensible Application Markup Language (XAML), and the C# programming language.
 
-If you haven't already installed Visual Studio, go to the [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=button+cta&utm_content=download+vs2017) page to install it for free.
+If you haven't already installed Visual Studio, go to the [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=inline+link&utm_content=download+vs2017) page to install it for free.
 
 ## Create a project
 

docs/get-started/csharp/tutorial-wpf.md

@@ -20,6 +20,8 @@ ms.workload:
 
 By completing this walkthrough, you'll become familiar with many of the tools, dialog boxes, and designers that you can use when you develop applications with Visual Studio. You'll create a "Hello, World" application, design the UI, add code, and debug errors, while you learn about working in the integrated development environment ([IDE](visual-studio-ide.md)).
 
+If you haven't already installed Visual Studio, go to the [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=inline+link&utm_content=download+vs2017) page to install it for free.
+
 ## Configure the IDE
 
 When you start Visual Studio for the first time, you'll be prompted to sign in. This step is optional for this walkthrough. Next you may be shown a dialog box that asks you to choose your development settings and color theme. Keep the defaults and choose **Start Visual Studio**.

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

@@ -17,6 +17,8 @@ ms.workload:
 
 The Visual Studio *integrated development environment* is a creative launching pad that you can use to edit, debug, and build code, and then publish an app. An integrated development environment (IDE) is a feature-rich program that can be used for many aspects of software development. Over and above the standard editor and debugger that most IDEs provide, Visual Studio includes compilers, code completion tools, graphical designers, and many more features to ease the software development process.
 
+If you haven't already installed Visual Studio, go to the [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=inline+link&utm_content=download+vs2017) page to install it for free.
+
 ![The Visual Studio IDE](../media/visual-studio-ide.png)
 
 This image shows Visual Studio with an open project and several key tool windows you'll likely use:

docs/get-started/visual-basic/tutorial-console.md

@@ -20,7 +20,7 @@ ms.workload:
 
 In this tutorial for Visual Basic (VB), you'll use Visual Studio to create and run a few different console apps and explore some features of the [Visual Studio integrated development environment (IDE)](visual-studio-ide.md) while you do so.
 
-If you haven't already installed Visual Studio, go to the [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=button+cta&utm_content=download+vs2017) page to install it for free.
+If you haven't already installed Visual Studio, go to the [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=inline+link&utm_content=download+vs2017) page to install it for free.
 
 ## Create a project
 

docs/get-started/visual-basic/tutorial-debugger.md

@@ -36,7 +36,7 @@ In this tutorial, you will:
 
 * You must have Visual Studio 2017 installed and the **.NET desktop development** workload.
 
-    If you haven't already installed Visual Studio, go to the [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=button+cta&utm_content=download+vs2017) page to install it for free.
+    If you haven't already installed Visual Studio, go to the [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=inline+link&utm_content=download+vs2017) page to install it for free.
 
     If you need to install the workload but already have Visual Studio, click the **Open Visual Studio Installer** link in the left pane of the **New Project** dialog box (select **File** > **New** > **Project**). The Visual Studio Installer launches. Choose the **.NET desktop development** workload, then choose **Modify**.
 

docs/get-started/visual-basic/tutorial-editor.md

@@ -19,7 +19,7 @@ ms.workload:
 In this 10-minute introduction to the code editor in Visual Studio, we'll add code to a file to look at some of the ways that Visual Studio makes writing, navigating, and understanding code easier.
 
 > [!TIP]
-> If you haven't already installed Visual Studio, go to the [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=button+cta&utm_content=download+vs2017) page to install it for free.
+> If you haven't already installed Visual Studio, go to the [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=inline+link&utm_content=download+vs2017) page to install it for free.
 
 This article assumes you're already familiar with Visual Basic. If you aren't, we suggest you look at a tutorial such as [Get started with Visual Basic in Visual Studio](../../get-started/visual-basic/tutorial-console.md) first.
 

docs/ide/how-to-create-multi-project-templates.md

@@ -63,17 +63,20 @@ The root *vstemplate* file for a multi-project template differs from a single-pr
     </TemplateContent>
     ```
 
-## To create a multi-project template from an existing solution
+## Create a multi-project template from an existing solution
 
 1. Create a solution and add two or more projects.
 
 1. Customize the projects until they are ready to be exported to a template.
 
+   > [!TIP]
+   > If you're using [template parameters](template-parameters.md) and you want to refer to variables from the parent template, prefix the name of the parameter with `ext_`. For example, `$ext_safeprojectname$`.
+
 1. On the **Project** menu, choose **Export Template**.
 
    The **Export Template Wizard** opens.
 
-1. On the **Choose Template Type** page, select **Project Template**. Select the project you want to export to a template, and then choose **Next**.
+1. On the **Choose Template Type** page, select **Project Template**. Select one of the projects that you want to export to a template, and then choose **Next**. (You'll repeat these steps for each project in the solution.)
 
 1. On the **Select Template Options** page, enter a name and optional description, icon, and preview image for your template. Choose **Finish**.
 

docs/ide/how-to-substitute-parameters-in-a-template.md

@@ -19,7 +19,7 @@ Template parameters are written in the format $*parameter*$. For a complete list
 
 The following section shows you how to modify a template to replace the name of a namespace with the "safe project name".
 
-## To use a parameter to replace the namespace name
+## Example - namespace name
 
 1. Insert the parameter in one or more of the code files in the template. For example:
 

docs/ide/reference/immediate-window.md

@@ -96,7 +96,7 @@ Enter the greater than sign (>) when issuing Visual Studio commands in the **Imm
 
 When you click on any previous line in the **Immediate** window, you shift automatically into Mark mode. This allows you to select, edit, and copy the text of previous commands as you would in any text editor, and paste them into the current line.
 
-## The equals sign(=)
+## The equals sign (=)
 
 The window used to enter the `EvaluateStatement` command determines whether an equals sign (=) is interpreted as a comparison operator or as an assignment operator.
 

docs/ide/template-parameters.md

@@ -16,7 +16,7 @@ manager: jillfra
 
 You can replace values in your template when the template is instantiated. To set up this functionality, use *template parameters*. Template parameters can be used to replace values such as class names and namespaces in the template. The template wizard that runs in the background when a user adds a new item or project replaces these parameters.
 
-## Declaring and enabling template parameters
+## Declare and enable template parameters
 
 Template parameters are declared in the format $*parameter*$. For example:
 
@@ -26,7 +26,7 @@ Template parameters are declared in the format $*parameter*$. For example:
 
 - $guid5$
 
-### To enable parameter substitution in templates
+### Enable parameter substitution in templates
 
 1. In the *.vstemplate* file of the template, locate the `ProjectItem` element that corresponds to the item for which you want to enable parameter replacement.
 
@@ -40,11 +40,12 @@ Template parameters are declared in the format $*parameter*$. For example:
 
 ## Reserved template parameters
 
-The following table lists the reserved template parameters that can be used by any template.
+The following table lists the reserved template parameters that can be used by any template:
 
 |Parameter|Description|
 |---------------|-----------------|
 |clrversion|Current version of the common language runtime (CLR).|
+|ext_*|Add the `ext_` prefix to any parameter to refer to the variables of the parent template. For example, `ext_safeprojectname`.|
 |guid[1-10]|A GUID used to replace the project GUID in a project file. You can specify up to 10 unique GUIDs (for example, `guid1`).|
 |itemname|The name provided by the user in the **Add New Item** dialog box.|
 |machinename|The current computer name (for example, Computer01).|
@@ -112,6 +113,7 @@ In the *.vstemplate* file for the project template, include the `ReplaceParamete
 
 ## See also
 
+- [How to: Substitute parameters in a template](how-to-substitute-parameters-in-a-template.md)
 - [Customize templates](../ide/customizing-project-and-item-templates.md)
 - [How to: Create project templates](../ide/how-to-create-project-templates.md)
 - [Template Schema Reference](../extensibility/visual-studio-template-schema-reference.md)

docs/test/create-a-unit-test-project.md

@@ -1,6 +1,6 @@
 ---
 title: "Create a unit test project"
-ms.date: 11/04/2016
+ms.date: 01/29/2019
 ms.prod: visual-studio-dev15
 ms.topic: conceptual
 ms.author: gewarren
@@ -14,29 +14,29 @@ author: gewarren
 Unit tests often mirror the structure of the code under test. For example, a unit test project would be created for each code project in the product. The test project can be in the same solution as the production code, or it can be in a separate solution. You can have multiple unit test projects in a solution.
 
 > [!NOTE]
-> The location of unit tests for native code and the test project structure can be different than the structure that is described in this topic. For more information, see [Writing unit tests for C/C++](writing-unit-tests-for-c-cpp.md).
+> The location of unit tests for native code and the test project structure can be different than the structure that is described in this article. For more information, see [Writing unit tests for C/C++](writing-unit-tests-for-c-cpp.md).
 
-## To create a unit test project:
+## To create a unit test project
 
-1.  On the **File** menu, choose **New** and then choose **Project** (Keyboard **Ctrl**+**Shift**+**N**).
+1. On the **File** menu, choose **New** and then choose **Project**. Or, press **Ctrl**+**Shift**+**N**.
 
-2.  In the **New Project** dialog box, expand the **Installed** node, choose the language that you want to use for your test project, and then choose **Test**.
+2. In the **New Project** dialog box, expand the **Installed** node, choose the language that you want to use for your test project, and then choose **Test**.
 
-3.  To use one of the Microsoft unit test frameworks, choose **Unit Test Project** from the list of project templates. Otherwise, choose the project template of the unit test framework that you want to use. To test the Accounts project of our example, you would name the project **AccountsTests**.
+3. To use one of the Microsoft unit test frameworks, choose **Unit Test Project** from the list of project templates. Otherwise, choose the project template of the unit test framework that you want to use. Name the project, and then select **OK**.
 
-4.  In your unit test project, add a reference to the code under test.  Here's how to create the reference to a code project in the same solution:
+4. In your unit test project, add a reference to the code under test. To add a reference to a code project in the same solution:
 
-    1.  Select the project in **Solution Explorer**.
+   1. Select the test project in **Solution Explorer**.
 
-    2.  On the **Project** menu, choose **Add Reference**.
+   2. On the **Project** menu, choose **Add Reference**.
 
-    3.  In the **Reference Manager** dialog box, open the **Solution** node and choose **Projects**. Check the code project name and close the dialog box.
+   3. In **Reference Manager**, select the **Solution** node under **Projects**. Select the code project you want to test, and then select **OK**.
 
-5.  If the code that you want to test is in another location, see [Managing references in a project](../ide/managing-references-in-a-project.md) for information about adding references.
+   If the code that you want to test is in another location, see [Managing references in a project](../ide/managing-references-in-a-project.md) for information about adding a reference.
 
 ## Next steps
 
- See one of the following sections:
+See one of the following sections:
 
 **Writing unit tests**