Merge pull request #3197 from DennisLee-DennisLee/master

1329916: Fixed MSDN links in docs/modeling (48 files).

Author: v-shils

docs/modeling/adding-a-tracking-property-to-a-domain-specific-language-definition.md

@@ -22,7 +22,7 @@ A *tracking domain* property is a property that can be updated by the user but w
 
 For example, in the Domain-Specific Language Tools (DSL Tools), the Display Name property of a domain class has a default value that is calculated by using the name of the domain class, but a user can change the value at design time or reset it to the calculated value.
 
-In this walkthrough, you create a domain-specific language (DSL) that has a Namespace tracking property that has a default value based on the Default Namespace property of the model. For more information about tracking properties, see [Defining Tracking Properties](http://msdn.microsoft.com/0538b0e4-6221-4e7d-911a-b92cd622f0be).
+In this walkthrough, you create a domain-specific language (DSL) that has a Namespace tracking property that has a default value based on the Default Namespace property of the model. For more information about tracking properties, see [Defining Tracking Properties](https://msdn.microsoft.com/0538b0e4-6221-4e7d-911a-b92cd622f0be).
 
 - The DSL Tools support tracking property descriptors. However, the DSL designer cannot be used to add a tracking property to a language. Therefore, you must add custom code to define and implement the tracking property.
 

docs/modeling/code-generation-in-a-build-process.md

@@ -15,7 +15,7 @@ ms.technology: vs-ide-modeling
 ---
 # Code generation in a build process
 
-[Text transformation](../modeling/code-generation-and-t4-text-templates.md) can be invoked as part of the [build process](http://msdn.microsoft.com/Library/a971b0f9-7c28-479d-a37b-8fd7e27ef692) of a Visual Studio solution. There are build tasks that are specialized for text transformation. The T4 build tasks run design-time text templates, and they also compile run-time (preprocessed) text templates.
+[Text transformation](../modeling/code-generation-and-t4-text-templates.md) can be invoked as part of the [build process](/azure/devops/pipelines/index) of a Visual Studio solution. There are build tasks that are specialized for text transformation. The T4 build tasks run design-time text templates, and they also compile run-time (preprocessed) text templates.
 
 There are some differences in what the build tasks can do, depending on which build engine you use. When you build the solution in Visual Studio, a text template can access the Visual Studio API (EnvDTE) if the [hostspecific="true"](../modeling/t4-template-directive.md) attribute is set. But that isn't true when you build the solution from the command line or when you initiate a server build through Visual Studio. In those cases, the build is performed by MSBuild and a different T4 host is used.
 
@@ -27,7 +27,7 @@ To enable build tasks on your development computer, install Modeling SDK for Vis
 
 [!INCLUDE[modeling_sdk_info](includes/modeling_sdk_info.md)]
 
-If [your build server](http://msdn.microsoft.com/Library/788443c3-0547-452e-959c-4805573813a9) runs on a computer on which Visual Studio is not installed, copy the following files to the build computer from your development machine. Substitute the most recent version numbers for '*'.
+If [your build server](/azure/devops/pipelines/agents/agents) runs on a computer on which Visual Studio is not installed, copy the following files to the build computer from your development machine. Substitute the most recent version numbers for '*'.
 
 - $(ProgramFiles)\MSBuild\Microsoft\VisualStudio\v*.0\TextTemplating
 
@@ -230,7 +230,7 @@ In a text template, set `hostspecific` in the template directive. Use the [param
 The project folder is: <#= ProjectFolder #>
 ```
 
-In a directive processor, you can call [ITextTemplatingEngineHost.ResolveParameterValue](https://msdn.microsoft.com/library/microsoft.visualstudio.texttemplating.itexttemplatingenginehost.resolveparametervalue.aspx):
+In a directive processor, you can call [ITextTemplatingEngineHost.ResolveParameterValue](/previous-versions/visualstudio/visual-studio-2012/bb126369\(v\=vs.110\)):
 
 ```csharp
 string value = Host.ResolveParameterValue("-", "-", "parameterName");
@@ -291,4 +291,4 @@ If you update an included file, or another file read by the template, Visual Stu
 ## See also
 
 - There is good guidance in the T4 MSbuild template at *%ProgramFiles(x86)%\Microsoft Visual Studio\2017\Enterprise\msbuild\Microsoft\VisualStudio\v15.0\TextTemplating\Microsoft.TextTemplating.targets*
-- [Write a T4 text template](../modeling/writing-a-t4-text-template.md)
+- [Write a T4 text template](../modeling/writing-a-t4-text-template.md)

docs/modeling/create-models-for-your-app.md

@@ -46,10 +46,10 @@ To visualize the architecture of a system or existing code, create the following
 |[Model user requirements](../modeling/model-user-requirements.md)|Use models to clarify and communicate the users' needs.|
 |[Model your app's architecture](../modeling/model-your-app-s-architecture.md)|Use models to describe the overall structure and behavior of your system and to make sure that it meets the users' needs.|
 |[Validate your system during development](../modeling/validate-your-system-during-development.md)|Make sure that your software stays consistent with your users' needs and the overall architecture of your system.|
-|[Use models in your development process](../modeling/use-models-in-your-development-process.md)<br /><br /> [Use models in Agile development](http://msdn.microsoft.com/592ac27c-3d3e-454a-9c38-b76658ed137f)|Use models to help you understand and change your system during its development.|
+|[Use models in your development process](../modeling/use-models-in-your-development-process.md)<br /><br /> [Use models in Agile development](https://msdn.microsoft.com/592ac27c-3d3e-454a-9c38-b76658ed137f)|Use models to help you understand and change your system during its development.|
 |[Structure your modeling solution](../modeling/structure-your-modeling-solution.md)|Organize models in a large or medium project.|
 
 ## Resources
 
 - [Visual Studio Visualization & Modeling Tools Forum](http://go.microsoft.com/fwlink/?LinkId=184720)
-- [Visual Studio Extensibility Forum](https://social.msdn.microsoft.com/Forums/vstudio/en-US/home?forum=vsx)
+- [Visual Studio Extensibility Forum](https://social.msdn.microsoft.com/Forums/vstudio/home?forum=vsx)

docs/modeling/create-uml-modeling-projects-and-diagrams.md

@@ -15,13 +15,13 @@ ms.technology: vs-ide-modeling
 ---
 # Create UML modeling projects and diagrams
 
-Starting with Visual Studio 2017, the UML Designers have been removed from Visual Studio. For more information, see this [blog post](https://blogs.msdn.microsoft.com/visualstudioalm/2016/10/14/uml-designers-have-been-removed-layer-designer-now-supports-live-architectural-analysis/).
+Starting with Visual Studio 2017, the UML Designers have been removed from Visual Studio. For more information, see this [blog post](https://blogs.msdn.microsoft.com/devops/2016/10/14/uml-designers-have-been-removed-layer-designer-now-supports-live-architectural-analysis/).
 
 If you still need to use UML, you can use Visual Studio 2015 Enterprise edition, which is side-by-side compatible with later versions of Visual Studio.
 
 For information about using UML in Visual Studio 2015, see:
 
-* [Analyze and model your architecture](https://msdn.microsoft.com/library/57b85fsc%28v=vs.140%29.aspx)
+* [Analyze and model your architecture](analyze-and-model-your-architecture.md)
 * [Create models for your app](create-models-for-your-app.md)
 * [Use models in your development process](use-models-in-your-development-process.md)
 * [Validate your system during development](validate-your-system-during-development.md)

docs/modeling/customizing-element-creation-and-movement.md

@@ -316,4 +316,4 @@ You can create a forward merge directive in the Component Model solution. If you
 
 - [Navigating and Updating a Model in Program Code](../modeling/navigating-and-updating-a-model-in-program-code.md)
 - [Customizing Tools and the Toolbox](../modeling/customizing-tools-and-the-toolbox.md)
-- [Circuit Diagrams sample DSL](http://code.msdn.microsoft.com/Visualization-Modeling-SDK-763778e8)
+- [Circuit Diagrams sample DSL](https://code.msdn.microsoft.com/Visualization-Modeling-SDK-763778e8)

docs/modeling/customizing-the-model-explorer.md

@@ -109,4 +109,4 @@ You can change the appearance and behavior of the explorer for your domain-speci
 
 ## See also
 
-- [Domain-Specific Language Tools Glossary](http://msdn.microsoft.com/ca5e84cb-a315-465c-be24-76aa3df276aa)
+- [Domain-Specific Language Tools Glossary](https://msdn.microsoft.com/ca5e84cb-a315-465c-be24-76aa3df276aa)

docs/modeling/customizing-tools-and-the-toolbox.md

@@ -234,4 +234,4 @@ using Microsoft.VisualStudio.Modeling.Diagrams;
 - [Customizing Copy Behavior](../modeling/customizing-copy-behavior.md)
 - [How to: Add a Drag-and-Drop Handler](../modeling/how-to-add-a-drag-and-drop-handler.md)
 - [Navigating and Updating a Model in Program Code](../modeling/navigating-and-updating-a-model-in-program-code.md)
-- [Circuit Diagrams sample DSL](http://code.msdn.microsoft.com/Visualization-Modeling-SDK-763778e8)
+- [Circuit Diagrams sample DSL](https://code.msdn.microsoft.com/Visualization-Modeling-SDK-763778e8)

docs/modeling/design-time-code-generation-by-using-t4-text-templates.md

@@ -290,7 +290,7 @@ Number of projects in this VS solution:  <#= dte.Solution.Projects.Count #>
 
 > [!NOTE]
 > In Visual Studio 2017, the Text Template Transformation SDK and the Visual Studio Modeling SDK are installed automatically when you install specific features of Visual Studio. For more details, see
-[this blog post](https://blogs.msdn.microsoft.com/visualstudioalm/2016/12/12/the-visual-studio-modeling-sdk-is-now-available-with-visual-studio-2017/).
+[this blog post](https://blogs.msdn.microsoft.com/devops/2016/12/12/the-visual-studio-modeling-sdk-is-now-available-with-visual-studio-2017/).
 
 ```xml
 <Import Project="$(MSBuildExtensionsPath)\Microsoft\VisualStudio\v15.0\TextTemplating\Microsoft.TextTemplating.targets" />

docs/modeling/event-handlers-propagate-changes-outside-the-model.md

@@ -183,6 +183,6 @@ Each event type corresponds to a collection in Store.EventManagerDirectory. You
 ## See Also
 
 - [Responding to and Propagating Changes](../modeling/responding-to-and-propagating-changes.md)
-- [Sample code: Circuit Diagrams](http://code.msdn.microsoft.com/Visualization-Modeling-SDK-763778e8)
+- [Sample code: Circuit Diagrams](https://code.msdn.microsoft.com/Visualization-Modeling-SDK-763778e8)
 
 [!INCLUDE[modeling_sdk_info](includes/modeling_sdk_info.md)]

docs/modeling/generating-files-with-the-texttransform-utility.md

@@ -56,7 +56,7 @@ TextTransform [<options>] <templateName>
 |**-I** \<includedirectory>|A directory that contains the text templates included in the specified text template.|
 |**-P** \<referencepath>|A directory to search for assemblies specified within the text template or for using the **-r** option.<br /><br /> For example, to include assemblies used for the Visual Studio API, use<br /><br /> `-P "%VSSHELLFOLDER%\Common7\IDE\PublicAssemblies"`|
 |**-dp** \<processorName>!\<className>!\<assemblyName&#124;codeBase>|The name, full type name, and assembly of a directive processor that can be used to process custom directives within the text template.|
-|**-a** [processorName]![directiveName]!\<parameterName>!\<parameterValue>|Specify a parameter value for a directive processor. If you specify just the parameter name and value, the parameter will be available to all directive processors. If you specify a directive processor, the parameter is available only to the specified processor. If you specify a directive name, the parameter is available only when the specified directive is being processed.<br /><br /> To access the parameter values from a directive processor or text template, use [ITextTemplatingEngineHost.ResolveParameterValue](https://msdn.microsoft.com/library/microsoft.visualstudio.texttemplating.itexttemplatingenginehost.resolveparametervalue.aspx). In a text template, include `hostspecific` in the template directive and invoke the message on `this.Host`. For example:<br /><br /> `<#@template language="c#" hostspecific="true"#> [<#= this.Host.ResolveParameterValue("", "", "parameterName") #>]`.<br /><br /> Always type the '!' marks, even if you omit the optional processor and directive names. For example:<br /><br /> `-a !!param!value`|
+|**-a** [processorName]![directiveName]!\<parameterName>!\<parameterValue>|Specify a parameter value for a directive processor. If you specify just the parameter name and value, the parameter will be available to all directive processors. If you specify a directive processor, the parameter is available only to the specified processor. If you specify a directive name, the parameter is available only when the specified directive is being processed.<br /><br /> To access the parameter values from a directive processor or text template, use [ITextTemplatingEngineHost.ResolveParameterValue](/previous-versions/visualstudio/visual-studio-2012/bb126369\(v\=vs.110\)). In a text template, include `hostspecific` in the template directive and invoke the message on `this.Host`. For example:<br /><br /> `<#@template language="c#" hostspecific="true"#> [<#= this.Host.ResolveParameterValue("", "", "parameterName") #>]`.<br /><br /> Always type the '!' marks, even if you omit the optional processor and directive names. For example:<br /><br /> `-a !!param!value`|
 |**-h**|Provides help.|
 
 ## Related topics
@@ -65,4 +65,4 @@ TextTransform [<options>] <templateName>
 |-|-|
 |Generate files in a Visual Studio solution.|[Design-Time Code Generation by using T4 Text Templates](../modeling/design-time-code-generation-by-using-t4-text-templates.md)|
 |Write directive processors to transform your own data sources.|[Customizing T4 Text Transformation](../modeling/customizing-t4-text-transformation.md)|
-|Write a text templating host that allows you to invoke text templates from your own application.|[Processing Text Templates by using a Custom Host](../modeling/processing-text-templates-by-using-a-custom-host.md)|
+|Write a text templating host that allows you to invoke text templates from your own application.|[Processing Text Templates by using a Custom Host](../modeling/processing-text-templates-by-using-a-custom-host.md)|

docs/modeling/getting-started-with-domain-specific-languages.md

@@ -15,7 +15,7 @@ ms.technology: vs-ide-modeling
 This topic explains the basic concepts in defining and using a domain-specific language (DSL) created with the Modeling SDK for Visual Studio.
 
 > [!NOTE]
-> In Visual Studio 2017, the Text Template Transformation SDK and the Visual Studio Modeling SDK are installed automatically when you install specific features of Visual Studio. For more details, see [this blog post](https://blogs.msdn.microsoft.com/visualstudioalm/2016/12/12/the-visual-studio-modeling-sdk-is-now-available-with-visual-studio-2017/).
+> In Visual Studio 2017, the Text Template Transformation SDK and the Visual Studio Modeling SDK are installed automatically when you install specific features of Visual Studio. For more details, see [this blog post](https://blogs.msdn.microsoft.com/devops/2016/12/12/the-visual-studio-modeling-sdk-is-now-available-with-visual-studio-2017/).
 
 If you are new to DSLs, we recommend that you work through the **DSL Tools Lab**, which you can find in this site: [Visualizaton and Modeling SDK](http://go.microsoft.com/fwlink/?LinkID=186128)
 
@@ -106,7 +106,7 @@ You can run the DSL solution as soon as you have created it. Later, you can modi
 1.  Click **Transform All Templates** in the **Solution Explorer** toolbar. This regenerates most of the source code from DslDefinition.dsl.
 
     > [!NOTE]
-    > Whenever you change *DslDefinition.dsl*, you must click **Transform All Templates** before you rebuild the solution. You can automate this step. For more information, see [How to Automate Transform All Templates](http://msdn.microsoft.com/b63cfe20-fe5e-47cc-9506-59b29bca768a).
+    > Whenever you change *DslDefinition.dsl*, you must click **Transform All Templates** before you rebuild the solution. You can automate this step. For more information, see [How to Automate Transform All Templates](/previous-versions/visualstudio/visual-studio-2012/ff521399\(v\=vs.110\)).
 
 2.  Press **F5**, or on the **Debug** menu, click **Start Debugging**.
 

docs/modeling/how-to-add-a-command-to-the-shortcut-menu.md

@@ -356,6 +356,6 @@ protected override IList<MenuCommand> GetMenuCommands()
 - [Writing Code to Customise a Domain-Specific Language](../modeling/writing-code-to-customise-a-domain-specific-language.md)
 - [How to: Modify a Standard Menu Command](../modeling/how-to-modify-a-standard-menu-command-in-a-domain-specific-language.md)
 - [Deploying Domain-Specific Language Solutions](../modeling/deploying-domain-specific-language-solutions.md)
-- [Sample code: Circuit Diagrams](http://code.msdn.microsoft.com/Visualization-Modeling-SDK-763778e8)
+- [Sample code: Circuit Diagrams](https://code.msdn.microsoft.com/Visualization-Modeling-SDK-763778e8)
 
 [!INCLUDE[modeling_sdk_info](includes/modeling_sdk_info.md)]

docs/modeling/how-to-change-the-namespace-of-a-domain-specific-language.md

@@ -1,6 +1,6 @@
 ---
-title: "How to: Change the Namespace of a Domain-Specific Language"
-ms.date: 11/04/2016
+title: "How to: Change the namespace of a domain-specific language"
+ms.date: 10/31/2018
 ms.topic: conceptual
 helpviewer_keywords:
   - "Domain-Specific Language, namespace"
@@ -12,41 +12,42 @@ ms.workload:
 ms.prod: visual-studio-dev15
 ms.technology: vs-ide-modeling
 ---
-# How to: Change the Namespace of a Domain-Specific Language
-You can change the namespace of a domain-specific language. You must make the change in the **DSL Explorer**, in the properties of the Dsl Package project, and in the assembly information.
+# How to: Change the namespace of a domain-specific language
 
-### To change the namespace of a domain-specific language
+You can change the namespace of a domain-specific language. Make the change in the **DSL Explorer**, in the properties of the Dsl Package project, and in the assembly information.
 
-1.  In **DSL Explorer**, click the **Dsl** node.
+## To change the namespace of a domain-specific language
 
-2.  In the **Properties** window, change the **Namespace** property.
+1. In **DSL Explorer**, select the **Dsl** node.
 
-3.  Save the solution and transform the templates.
+2. In the **Properties** window, change the **Namespace** property.
 
-4.  On the **Project** menu, click **Dsl Properties**.
+3. Save the solution and transform the templates.
 
-     The properties for your project appear.
+4. On the **Project** menu, choose **Dsl Properties**.
 
-5.  Click the **Application** tab.
+   The properties for your project appear.
 
-6.  Change the **Default namespace** property to the new namespace name.
+5. Select the **Application** tab.
 
-7.  If you also want to change the name of the assembly, change the **Assembly name property.**
+6. Change the **Default namespace** property to the new namespace name.
 
-8.  If you have changed the Assembly name, open DslPackage\Package.tt and update this line:
+7. If you also want to change the name of the assembly, change the **Assembly name property.**
 
-     `string dslAssembly = "YourDSLassembly.Dsl.dll";`
+8. If you have changed the Assembly name, open DslPackage\Package.tt and update this line:
+
+   `string dslAssembly = "YourDSLassembly.Dsl.dll";`
 
 9. If you have written any custom code, make sure to change the namespace and class references in the code files.
 
 10. Reset the Visual Studio Experimental instance.
 
-    1.  Delete **\Users\\**_{your name}_**\AppData\Local\Microsoft\VisualStudio\\\*Exp**
+    1. Delete **\Users\\**_{your name}_**\AppData\Local\Microsoft\VisualStudio\\\*Exp**.
 
-    2.  On the Windows **Start** menu, choose **All Programs**, **Microsoft Visual Studio 2010 SDK**, **Tools**, **Reset the Experimental Instance**.
+    2. On the Windows **Start** menu, choose **All Programs** > **Microsoft Visual Studio 2010 SDK** > **Tools** > **Reset the Experimental Instance**.
 
 11. On the **Build** menu, choose **Rebuild Solution**.
 
 ## See also
 
-- [Domain-Specific Language Tools Glossary](http://msdn.microsoft.com/ca5e84cb-a315-465c-be24-76aa3df276aa)
+[Domain-specific language tools glossary](https://msdn.microsoft.com/ca5e84cb-a315-465c-be24-76aa3df276aa)