Skip to content

Fix git push error for protected CLA branch #3223

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 10 commits into from
May 9, 2019
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 36 additions & 1 deletion .openpublishing.redirection.json
Original file line number Diff line number Diff line change
Expand Up @@ -1890,6 +1890,11 @@
"redirect_url": "/visualstudio/install/create-an-offline-installation-of-visual-studio",
"redirect_document_id": false
},
{
"source_path": "docs/modeling/customizing-presentation-on-the-diagram.md",
"redirect_url": "/visualstudio/modeling/defining-shapes-and-connectors",
"redirect_document_id": false
},
{
"source_path": "docs/modeling/deploy-a-layer-model-extension.md",
"redirect_url": "/visualstudio/modeling/deploy-a-layer-model-extension?view=vs-2015",
Expand Down Expand Up @@ -2075,14 +2080,34 @@
"redirect_url": "/visualstudio/modeling/create-uml-modeling-projects-and-diagrams",
"redirect_document_id": false
},
{
"source_path": "docs/modeling/working-with-domain-specific-language-solutions.md",
"redirect_url": "/visualstudio/modeling/about-domain-specific-languages",
"redirect_document_id": false
},
{
"source_path": "docs/modeling/deploying-domain-specific-language-solutions.md",
"redirect_url": "/visualstudio/modeling/msi-and-vsix-deployment-of-a-dsl",
"redirect_document_id": false
},
{
"source_path": "docs/modeling/navigate-the-uml-model.md",
"redirect_url": "/visualstudio/modeling/create-uml-modeling-projects-and-diagrams",
"redirect_document_id": false
},
{
"source_path": "docs/modeling/writing-user-commands-and-actions.md",
"redirect_url": "/visualstudio/modeling/how-to-modify-a-standard-menu-command-in-a-domain-specific-language",
"redirect_document_id": false
},
{
"source_path": "docs/modeling/nesting-shapes.md",
"redirect_url": "/visualstudio/modeling/customizing-presentation-on-the-diagram",
"redirect_url": "/visualstudio/modeling/defining-shapes-and-connectors",
"redirect_document_id": false
},
{
"source_path": "docs/modeling/properties-of-model-elements.md",
"redirect_url": "/visualstudio/modeling/properties-of-a-dsl-definition",
"redirect_document_id": false
},
{
Expand Down Expand Up @@ -3325,6 +3350,16 @@
"redirect_url": "/visualstudio/ide/whats-new-visual-studio-2019",
"redirect_document_id": false
},
{
"source_path": "docs/workflow-designer/workflow-designer-ui-help.md",
"redirect_url": "/visualstudio/workflow-designer/browse-and-select-a-dotnet-type-dialog-box",
"redirect_document_id": false
},
{
"source_path": "docs/workflow-designer/using-the-activity-designers.md",
"redirect_url": "/visualstudio/workflow-designer/control-flow-activity-designers",
"redirect_document_id": false
},
{
"source_path": "docs/workflow-designer/activity-views-legacy.md",
"redirect_url": "/visualstudio/workflow-designer/developing-applications-with-the-workflow-designer",
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ You can define several command and gesture handlers in the same Visual Studio pr

## Requirements

See [Requirements](../modeling/extend-layer-diagrams.md#prereqs).
See [Requirements](../modeling/extend-layer-diagrams.md#requirements).

## Define a Command or Gesture in a New VSIX

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ You can package your layer validation extension into a Visual Studio Integration

## Requirements

See [Requirements](../modeling/extend-layer-diagrams.md#prereqs).
See [Requirements](../modeling/extend-layer-diagrams.md#requirements).

## Defining a Layer Validator in a New VSIX

Expand Down
40 changes: 13 additions & 27 deletions docs/modeling/analyze-and-model-your-architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,28 +3,15 @@ title: Analyze and model your architecture
ms.date: 11/04/2016
ms.topic: conceptual
helpviewer_keywords:
- "Visual Studio Ultimate, exploring code"
- "Visual Studio Ultimate, visualizing code"
- "diagrams - modeling"
- "Visual Studio ALM, modeling"
- "application, design"
- "architecture"
- "code visualization"
- "application design"
- "applications, architecture"
- "code exploration"
- "Visual Studio ALM, exploring code"
- "modeling"
- "application architecture"
- "application, modeling"
- "applications, modeling"
- "architecture [Visual Studio ALM], modeling"
- "application modeling"
- "Visual Studio Ultimate, modeling"
- "architecture [Visual Studio Ultimate], modeling"
- "application, architecture"
- "Visual Studio ALM, visualizing code"
- "applications, designing"
author: gewarren
ms.author: gewarren
manager: jillfra
Expand All @@ -43,22 +30,23 @@ Make sure your app meets architectural requirements by using Visual Studio archi

See [Scenario: Change your design using visualization and modeling](../modeling/scenario-change-your-design-using-visualization-and-modeling.md).

## To
## Article reference

|||
|-|-|
|**Visualize code**:<br /><br /> - See the code's organization and relationships by creating code maps. Visualize dependencies between assemblies, namespaces, classes, methods, and so on.<br />- See the class structure and members for a specific project by creating class diagrams from code.<br />- Find conflicts between your code and its design by creating dependency diagrams to validate code.|- [Visualize code](../modeling/visualize-code.md)<br />- [Working with Classes and Other Types (Class Designer)](../ide/class-designer/designing-and-viewing-classes-and-types.md)<br />- [Video: Understand design from code with Visual Studio 2015 code maps](https://channel9.msdn.com/Events/Visual-Studio/Connect-event-2015/502)<br />- [Video: Validate your architecture dependencies in real time](https://sec.ch9.ms/sessions/69613110-c334-4f25-bb36-08e5a93456b5/170ValidateArchitectureDependenciesWithVisualStudio.mp4)|
|**Define the architecture**:<br /><br /> - Define and enforce constraints on dependencies between the components of your code by creating dependency diagrams.|- [Video: Validate architecture dependencies with Visual Studio (Channel 9)](https://channel9.msdn.com/Events/Connect/2016/170)|
|**Validate your system with the requirements and intended design:**<br /><br /> - Validate code dependencies with dependency diagrams that describe the intended architecture and prevent changes that might conflict with the design.|- [Video: Validate architecture dependencies with Visual Studio (Channel 9)](https://channel9.msdn.com/Events/Connect/2016/170)|
|**Customize models and diagrams**:<br /><br /> - Create your own domain-specific languages.|- [Modeling SDK for Visual Studio - Domain-Specific Languages](../modeling/modeling-sdk-for-visual-studio-domain-specific-languages.md)|
|**Generate text using T4 templates**:<br /><br /> - Use text blocks and control logic inside templates to generate text-based files.<br /> - T4 template build with MSBuild included in Visual Studio|- [Code Generation and T4 Text Templates](../modeling/code-generation-and-t4-text-templates.md)|
|**Share models, diagrams, and code maps using Team Foundation version control**:<br /><br /> - Put code maps, projects, and dependency diagrams under Team Foundation version control so you can share them.| |
|**Visualize code**:<br /><br />- See the code's organization and relationships by creating code maps. Visualize dependencies between assemblies, namespaces, classes, methods, and so on.<br />- See the class structure and members for a specific project by creating class diagrams from code.<br />- Find conflicts between your code and its design by creating dependency diagrams to validate code.|- [Visualize code](../modeling/visualize-code.md)<br />- [Working with Classes and Other Types (Class Designer)](../ide/class-designer/designing-and-viewing-classes-and-types.md)<br />- [Video: Understand design from code with Visual Studio 2015 code maps](https://channel9.msdn.com/Events/Visual-Studio/Connect-event-2015/502)<br />- [Video: Validate your architecture dependencies in real time](https://sec.ch9.ms/sessions/69613110-c334-4f25-bb36-08e5a93456b5/170ValidateArchitectureDependenciesWithVisualStudio.mp4)|
|**Define the architecture**:<br /><br />- Define and enforce constraints on dependencies between the components of your code by creating dependency diagrams.|- [Video: Validate architecture dependencies with Visual Studio (Channel 9)](https://channel9.msdn.com/Events/Connect/2016/170)|
|**Validate your system with the requirements and intended design:**<br /><br />- Validate code dependencies with dependency diagrams that describe the intended architecture and prevent changes that might conflict with the design.|- [Video: Validate architecture dependencies with Visual Studio (Channel 9)](https://channel9.msdn.com/Events/Connect/2016/170)|
|**Customize models and diagrams**:<br /><br />- Create your own domain-specific languages.|- [Modeling SDK for Visual Studio - Domain-Specific Languages](../modeling/modeling-sdk-for-visual-studio-domain-specific-languages.md)|
|**Generate text using T4 templates**:<br /><br />- Use text blocks and control logic inside templates to generate text-based files.<br /> - T4 template build with MSBuild included in Visual Studio|- [Code Generation and T4 Text Templates](../modeling/code-generation-and-t4-text-templates.md)|
|**Share models, diagrams, and code maps using Team Foundation version control**:<br /><br />- Put code maps, projects, and dependency diagrams under Team Foundation version control so you can share them.| |

To see which editions of Visual Studio support each feature, see [Edition support for architecture and modeling tools](../modeling/what-s-new-for-design-in-visual-studio.md#VersionSupport)

## Types of models and typical uses

### Code maps

Code maps help you see the organization and relationships in your code.

**Typical uses:**
Expand All @@ -71,8 +59,9 @@ Code maps help you see the organization and relationships in your code.
- [Use code maps to debug your applications](../modeling/use-code-maps-to-debug-your-applications.md)
- [Find potential problems using code map analyzers](../modeling/find-potential-problems-using-code-map-analyzers.md)

### Dependency diagram
Dependency diagrams let you define the structure of an application as a set of layers or blocks with explicit dependencies. You can run validation to discover conflicts between dependencies in the code and dependencies described on a dependency diagram.
### Dependency diagrams

Dependency diagrams let you define the structure of an application as a set of layers or blocks with explicit dependencies. Live validation shows conflicts between dependencies in the code and dependencies described on a dependency diagram.

**Typical uses:**

Expand All @@ -86,7 +75,8 @@ Dependency diagrams let you define the structure of an application as a set of l
- [Validate code with dependency diagrams](../modeling/validate-code-with-layer-diagrams.md)

### Domain-specific language (DSL)
A DSL is a notation that you design for a specific purpose. In Visual Studio, it is usually graphical.

A DSL is a notation that you design for a specific purpose. In Visual Studio, it's usually graphical.

**Typical uses:**

Expand All @@ -97,10 +87,6 @@ A DSL is a notation that you design for a specific purpose. In Visual Studio, it

- [Modeling SDK for Visual Studio - Domain-Specific Languages](../modeling/modeling-sdk-for-visual-studio-domain-specific-languages.md)

## Where can I get more information?

[Visual Studio Visualization & Modeling Tools Forum](http://go.microsoft.com/fwlink/?LinkId=184720)

## See also

- [What's new for modeling in Visual Studio 2017](../modeling/what-s-new-for-design-in-visual-studio.md)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ manager: jillfra
ms.workload:
- "multiple"
---
# Creating Custom T4 Text Template Directive Processors
# Create Custom T4 Text Template Directive Processors

The *text template transformation process* takes a *text template* file as the input and produces a text file as the output. The *text template transformation engine* controls the process, and the engine interacts with a text template transformation host and one or more text template *directive processors* to complete the process. For more information, see [The Text Template Transformation Process](../modeling/the-text-template-transformation-process.md).

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,31 +10,30 @@ manager: jillfra
ms.workload:
- "multiple"
---
# Customizing and Extending a Domain-Specific Language
Visual Studio Modeling and Visualization SDK (VMSDK) provides several levels at which you can define modeling tools:
# Customize and extend a domain-specific language

1. Define a domain-specific language (DSL) using the DSL Definition diagram. You can quickly create a DSL with a diagrammatic notation, a readable XML form, and the basic tools that are required to generate code and other artifacts.
Visual Studio Modeling and Visualization SDK (VMSDK) provides several levels at which you can define modeling tools:

For more information, see [How to Define a Domain-Specific Language](../modeling/how-to-define-a-domain-specific-language.md).
1. Define a domain-specific language (DSL) using the DSL Definition diagram. You can quickly create a DSL with a diagrammatic notation, a readable XML form, and the basic tools that are required to generate code and other artifacts. For more information, see [How to Define a Domain-Specific Language](../modeling/how-to-define-a-domain-specific-language.md).

2. Fine-tune the DSL by using more advanced features of the DSL Definition. For example, you can make additional links appear when the user creates an element. These techniques are mostly achieved in the DSL Definition, and some require a few lines of program code.

3. Extend your modeling tools by using program code. VMSDK is designed specifically to make it easy to integrate your extensions with the code that is generated from the DSL Definition. For more information, see [Writing Code to Customize a Domain-Specific Language](../modeling/writing-code-to-customise-a-domain-specific-language.md).
3. Extend your modeling tools by using program code. VMSDK is designed specifically to make it easy to integrate your extensions with the code that is generated from the DSL Definition. For more information, see [Writing Code to Customize a Domain-Specific Language](../modeling/writing-code-to-customise-a-domain-specific-language.md).

> [!NOTE]
> When you have updated the DSL Definitions file, do not forget to click **Transform All Templates** in the toolbar of Solution Explorer before rebuilding your solution.
> When you have updated the DSL Definitions file, don't forget to click **Transform All Templates** in the toolbar of **Solution Explorer** before rebuilding your solution.

## <a name="customShapes"></a> In this Section
## Article reference

|To achieve this effect|Refer to this topic|
|-|-|
|Allow the user to set the color and style properties of a shape.|Right-click the shape or connector class, point to **Add Exposed**, and click an item.<br /><br /> See [Customizing Presentation on the Diagram](../modeling/customizing-presentation-on-the-diagram.md).|
|Allow the user to set the color and style properties of a shape.|Right-click the shape or connector class, point to **Add Exposed**, and click an item.|
|Different classes of model element look similar on the diagram, sharing properties such as initial height and width, color, tooltips.|Use inheritance between shapes or connector classes. Mappings between derived shapes and derived domain classes inherit the mapping details of the parents.<br /><br /> Or, map different domain classes to the same shape class.|
|A class of model element is displayed by different shapes contexts.|Map more than one shape class to the same domain class. When you build the solution, follow the error report and provide the requested code to decide what shape to use.|
|Shape color or other features such as font indicate current state.|See [Updating Shapes and Connectors to Reflect the Model](../modeling/updating-shapes-and-connectors-to-reflect-the-model.md).<br /><br /> Create a rule that updates the exposed properties. See [Rules Propagate Changes Within the Model](../modeling/rules-propagate-changes-within-the-model.md).<br /><br /> Or, use OnAssociatedPropertyChanged() to update non-exposed features such as link arrows or font.|
|Icon on shape changes to indicate state.|Set the visibility of the decorator mapping in the DSL Details window. Locate several image decorators on the same position. See [Updating Shapes and Connectors to Reflect the Model](../modeling/updating-shapes-and-connectors-to-reflect-the-model.md).<br /><br /> Or, override `ImageField.GetDisplayImage()`. See example in <xref:Microsoft.VisualStudio.Modeling.Diagrams.ImageField>.|
|Set a background image on any shape|Override InitializeInstanceResources() to add an anchored ImageField. See [Customizing Presentation on the Diagram](../modeling/customizing-presentation-on-the-diagram.md).|
|Nest shapes to any depth|Set up a recursive embedding tree. Define BoundsRules to contain the shapes. See [Customizing Presentation on the Diagram](../modeling/customizing-presentation-on-the-diagram.md).|
|Set a background image on any shape|Override InitializeInstanceResources() to add an anchored ImageField.|
|Nest shapes to any depth|Set up a recursive embedding tree. Define BoundsRules to contain the shapes.|
|Attach connectors at fixed points on an element's boundary.|Define embedded terminal elements, represented by small ports on the diagram. Use BoundsRules to fix the ports in place. See the Circuit Diagram sample at [Visualization and Modeling SDK](http://go.microsoft.com/fwlink/?LinkID=186128).|
|Text field displays a value derived from other values.|Map the text decorator to a Calculated or Custom Storage domain property. For more information, see [Calculated and Custom Storage Properties](../modeling/calculated-and-custom-storage-properties.md).|
|Propagate changes between model elements, or between shapes|See [Validation in a Domain-Specific Language](../modeling/validation-in-a-domain-specific-language.md).|
Expand Down
31 changes: 0 additions & 31 deletions docs/modeling/customizing-presentation-on-the-diagram.md

This file was deleted.

20 changes: 0 additions & 20 deletions docs/modeling/deploying-domain-specific-language-solutions.md

This file was deleted.

Loading