MicrosoftDocs · marxlumon · Apr 8, 2025 · Nov 12, 2025 · Nov 13, 2025 · Nov 13, 2025
diff --git a/docs/modeling/getting-started-with-domain-specific-languages.md b/docs/modeling/getting-started-with-domain-specific-languages.md
diff --git a/docs/modeling/media/create-new-domain-specific-language-project.png b/docs/modeling/media/create-new-domain-specific-language-project.png
diff --git a/docs/modeling/media/create-your-new-project.png b/docs/modeling/media/create-your-new-project.png
diff --git a/docs/modeling/media/define-new-model-file-type.png b/docs/modeling/media/define-new-model-file-type.png
diff --git a/docs/modeling/media/domain-specific-language-solution-summary.png b/docs/modeling/media/domain-specific-language-solution-summary.png
diff --git a/docs/modeling/media/family-class-diagram.png b/docs/modeling/media/family-class-diagram.png
diff --git a/docs/modeling/media/family-definition-diagram.png b/docs/modeling/media/family-definition-diagram.png
diff --git a/docs/modeling/media/family-map-property-decorator.png b/docs/modeling/media/family-map-property-decorator.png
diff --git a/docs/modeling/media/family-town-shape-map.png b/docs/modeling/media/family-town-shape-map.png
diff --git a/docs/modeling/media/family-tree-model-sample.png b/docs/modeling/media/family-tree-model-sample.png
diff --git a/docs/modeling/media/family-tree-towns.png b/docs/modeling/media/family-tree-towns.png
diff --git a/docs/modeling/media/minimal-language-project-template.png b/docs/modeling/media/minimal-language-project-template.png
diff --git a/docs/modeling/media/tudors-family-tree.png b/docs/modeling/media/tudors-family-tree.png
diff --git a/docs/modeling/modeling-sdk-for-visual-studio-domain-specific-languages.md b/docs/modeling/modeling-sdk-for-visual-studio-domain-specific-languages.md
@@ -3,7 +3,7 @@ title: Use the Modeling SDK for Visual Studio
 description: Use the Modeling SDK for Visual Studio to create powerful model-based development tools that integrate into Visual Studio.
 titleSuffix: ''
 ms.date: 11/04/2016
-ms.topic: concept-article
+ms.topic: conceptual
 helpviewer_keywords:
 - Domain-Specific Language Tools
 - Domain-Specific Language
@@ -14,11 +14,11 @@ ms.subservice: modeling
 ---
 # Modeling SDK for Visual Studio - Domain-Specific Languages
 
-By using the Modeling SDK for Visual Studio, you can create powerful model-based development tools that you can integrate into Visual Studio. In the same manner, you can create one or more model definitions and integrate them into a set of tools.
+By using the Modeling SDK for Visual Studio (VMSDK), you can create powerful model-based development tools that you can integrate into Visual Studio. In the same manner, you can create one or more model definitions and integrate them into a set of tools.
 
-At the heart of MSDK is the definition of a model that you create to represent concepts in your business area. You can surround the model with a variety of tools, such as a diagrammatic view, the ability to generate code and other artifacts, commands for transforming the model, and the ability to interact with code and other objects in Visual Studio. As you develop the model, you can combine it with other models and tools to form a powerful toolset that is centered on your development.
+At the heart of VMSDK is the definition of a model that you create to represent concepts in your business area. You can surround the model with a variety of tools, such as a diagrammatic view, the ability to generate code and other artifacts, commands for transforming the model, and the ability to interact with code and other objects in Visual Studio. As you develop the model, you can combine it with other models and tools to form a powerful toolset that is centered on your development.
 
-MSDK lets you develop a model quickly in the form of a domain-specific language (DSL). You begin by using a specialized editor to define a schema or abstract syntax together with a graphical notation. From this definition, VMSDK generates:
+VMSDK lets you develop a model quickly in the form of a domain-specific language (DSL). You begin by using a specialized editor to define a schema or abstract syntax together with a graphical notation. From this definition, VMSDK generates:
 
 - A model implementation with a strongly-typed API that runs in a transaction-based store.
 

diff --git a/docs/modeling/validation-in-a-domain-specific-language.md b/docs/modeling/validation-in-a-domain-specific-language.md
@@ -1,8 +1,8 @@
 ---
 title: Validation in a Domain-Specific Language
 description: Learn how you can define validation constraints to verify that the model created by the user is meaningful.
-ms.date: 11/04/2016
-ms.topic: article
+ms.date: 11/13/2025
+ms.topic: conceptual
 helpviewer_keywords:
 - Domain-Specific Language, constraints
 - Domain-Specific Language, validation
@@ -83,6 +83,8 @@ As the author of a domain-specific language (DSL), you can define validation con
 using Microsoft.VisualStudio.Modeling;
 using Microsoft.VisualStudio.Modeling.Validation;
 
+namespace Company.FamilyTree
+{
 // Allow validation methods in this class:
 [ValidationState(ValidationState.Enabled)]
 // In this DSL, ParentsHaveChildren is a domain relationship
@@ -116,6 +118,7 @@ public partial class ParentsHaveChildren
                        this.Parent);
     }
   }
+}
 ```
 
  Notice the following points about this code:
@@ -141,7 +144,7 @@ public partial class ParentsHaveChildren
 
 |Category|Execution|
 |-|-|
-|<xref:Microsoft.VisualStudio.Modeling.Validation.ValidationCategories>|When the user invokes the Validate menu command.|
+|<xref:Microsoft.VisualStudio.Modeling.Validation.ValidationCategories.Menu>|When the user invokes the Validate menu command.|
 |<xref:Microsoft.VisualStudio.Modeling.Validation.ValidationCategories>|When the model file is opened.|
 |<xref:Microsoft.VisualStudio.Modeling.Validation.ValidationCategories>|When the file is saved. If there are validation errors, the user will be given the option of canceling the save operation.|
 |<xref:Microsoft.VisualStudio.Modeling.Validation.ValidationCategories>|When the file is saved. If there are errors from methods in this category, the user is warned that it might not be possible to re-open the file.<br /><br /> Use this category for validation methods that test for duplicated names or IDs, or other conditions that might cause loading errors.|