Skip to content

Conversation

@marxlumon
Copy link
Contributor

The docs contained broken links and legacy content. We are really need this VMSDK (formerly DSL Tools) and this pull request is a first try to make it actual.

The link to Jean-Marc Prieur’s VMSDK Labs https://code.msdn.microsoft.com/Visualization-and-Modeling-313535db is broken. The renewed version of these labs and original docs can be found at https://github.com/lumon-Ind/VMSDK.git. The broken link have been replaced by this repo link. Feel free to use it as you need.

Actual pictures, titles, links. The link at DSL Lab is temporal - https://github.com/lumon-Ind/MoSDK-Lab, and will be fixed in release.
@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit de1a0fd:

⚠️ Validation status: warnings

File Status Preview URL Details
docs/modeling/media/dsl_min_2.png ⚠️Warning Details
docs/modeling/media/familyt_class_diagr.png ⚠️Warning Details
docs/modeling/media/familyt_diagr.png ⚠️Warning Details
docs/modeling/media/familyt_map_prop_decor.png ⚠️Warning Details
docs/modeling/media/familyt_town_shape_map.png ⚠️Warning Details
docs/modeling/media/familyt_towns.png ⚠️Warning Details
docs/modeling/media/familyt_tudors.png ⚠️Warning Details
docs/modeling/getting-started-with-domain-specific-languages.md 💡Suggestion Details
docs/modeling/modeling-sdk-for-visual-studio-domain-specific-languages.md ✅Succeeded
docs/modeling/validation-in-a-domain-specific-language.md ✅Succeeded

docs/modeling/media/dsl_min_2.png

  • Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/modeling/media/familyt_class_diagr.png

  • Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/modeling/media/familyt_diagr.png

  • Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/modeling/media/familyt_map_prop_decor.png

  • Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/modeling/media/familyt_town_shape_map.png

  • Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/modeling/media/familyt_towns.png

  • Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/modeling/media/familyt_tudors.png

  • Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

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

  • Line 58, Column 4: [Suggestion: duplicate-alt-text - See documentation] Alt text 'image' is duplicated. Within an article, alt text must be unique.
  • Line 62, Column 6: [Suggestion: duplicate-alt-text - See documentation] Alt text 'image' is duplicated. Within an article, alt text must be unique.
  • Line 67, Column 6: [Suggestion: duplicate-alt-text - See documentation] Alt text 'image' is duplicated. Within an article, alt text must be unique.
  • Line 76, Column 6: [Suggestion: duplicate-alt-text - See documentation] Alt text 'image' is duplicated. Within an article, alt text must be unique.
  • Line 85, Column 4: [Suggestion: duplicate-alt-text - See documentation] Alt text 'image' is duplicated. Within an article, alt text must be unique.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@ktoliver
Copy link
Contributor

@marxlumon - Thank you for your contribution. Would you take a moment to sign the Contributor License Agreement (CLA)? After the CLA is signed, someone can review your pull request. Thanks!

@ktoliver ktoliver added the aq-pr-triaged tracking label for the PR review team label Nov 13, 2025
@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 0f4c60b:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File Status Preview URL Details
❌Error Details

  • [Error: CannotMergeCommit] Cannot merge commit 0f4c60bdff36f9625ef82a0c7b6a257ff0bc8168 in branch patch-2 of repository https://github.com/marxlumon/visualstudio-docs into branch main (commit ee3450eb9f68fbb69a8ac16329db207886090b03). Please follow this documentation: https://help.github.com/articles/resolving-a-merge-conflict-using-the-command-line/ to use git.exe to resolve you content conflicts locally and then push to remote.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 6924d97:

⚠️ Validation status: warnings

File Status Preview URL Details
docs/modeling/getting-started-with-domain-specific-languages.md ⚠️Warning Details
docs/modeling/media/create_new_dsl_project.png ⚠️Warning Details
docs/modeling/media/create_your_new_project.png ⚠️Warning Details
docs/modeling/media/define_new_model_file_type.png ⚠️Warning Details
docs/modeling/media/dsl_solution_summary.png ⚠️Warning Details
docs/modeling/media/family_class_diagram.png ⚠️Warning Details
docs/modeling/media/family_definition_diagram.png ⚠️Warning Details
docs/modeling/media/family_map_property_decorator.png ⚠️Warning Details
docs/modeling/media/family_town_shape_map.png ⚠️Warning Details
docs/modeling/media/family_tree_model_sample.png ⚠️Warning Details
docs/modeling/media/family_tree_towns.png ⚠️Warning Details
docs/modeling/media/minimal_language_project_template.png ⚠️Warning Details
docs/modeling/media/tudors_family_tree.png ⚠️Warning Details
docs/modeling/modeling-sdk-for-visual-studio-domain-specific-languages.md ✅Succeeded
docs/modeling/validation-in-a-domain-specific-language.md ✅Succeeded

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

  • Line 26, Column 1: [Warning: file-not-found - See documentation] Invalid file link: '../modeling/media/'.
  • Line 304, Column 1: [Warning: file-not-found - See documentation] Invalid file link: '../modeling/media/familyt_tudors.png'.

docs/modeling/media/create_new_dsl_project.png

  • Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/modeling/media/create_your_new_project.png

  • Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/modeling/media/define_new_model_file_type.png

  • Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/modeling/media/dsl_solution_summary.png

  • Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/modeling/media/family_class_diagram.png

  • Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/modeling/media/family_definition_diagram.png

  • Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/modeling/media/family_map_property_decorator.png

  • Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/modeling/media/family_town_shape_map.png

  • Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/modeling/media/family_tree_model_sample.png

  • Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/modeling/media/family_tree_towns.png

  • Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/modeling/media/minimal_language_project_template.png

  • Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/modeling/media/tudors_family_tree.png

  • Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.

This comment lists only the first 25 errors (including error/warning/suggestion) in the pull request.
For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@marxlumon
Copy link
Contributor Author

@microsoft-github-policy-service agree

@prmerger-automator
Copy link
Contributor

@marxlumon : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

@prmerger-automator
Copy link
Contributor

@marxlumon : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 0ae06f9:

⚠️ Validation status: warnings

File Status Preview URL Details
docs/modeling/getting-started-with-domain-specific-languages.md ⚠️Warning Details
docs/modeling/media/family_class_diagram.png ⚠️Warning Details
docs/modeling/media/create-new-dsl-project.png 💡Suggestion Details
docs/modeling/media/dsl-solution-summary.png 💡Suggestion Details
docs/modeling/media/create-your-new-project.png ✅Succeeded
docs/modeling/media/define-new-model-file-type.png ✅Succeeded
docs/modeling/media/family-class-diagram.png ✅Succeeded
docs/modeling/media/family-definition-diagram.png ✅Succeeded
docs/modeling/media/family-map-property-decorator.png ✅Succeeded
docs/modeling/media/family-town-shape-map.png ✅Succeeded
docs/modeling/media/family-tree-model-sample.png ✅Succeeded
docs/modeling/media/family-tree-towns.png ✅Succeeded
docs/modeling/media/minimal-language-project-template.png ✅Succeeded
docs/modeling/media/tudors-family-tree.png ✅Succeeded
docs/modeling/modeling-sdk-for-visual-studio-domain-specific-languages.md ✅Succeeded
docs/modeling/validation-in-a-domain-specific-language.md ✅Succeeded

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

  • Line 304, Column 1: [Warning: file-not-found - See documentation] Invalid file link: '../modeling/media/familyt_tudors.png'.

docs/modeling/media/family_class_diagram.png

  • Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/modeling/media/create-new-dsl-project.png

  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/modeling/media/dsl-solution-summary.png

  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit d11d261:

⚠️ Validation status: warnings

File Status Preview URL Details
docs/modeling/media/family_class_diagram.png ⚠️Warning Details
docs/modeling/media/create-new-dsl-project.png 💡Suggestion Details
docs/modeling/media/dsl-solution-summary.png 💡Suggestion Details
docs/modeling/getting-started-with-domain-specific-languages.md ✅Succeeded
docs/modeling/media/create-your-new-project.png ✅Succeeded
docs/modeling/media/define-new-model-file-type.png ✅Succeeded
docs/modeling/media/family-class-diagram.png ✅Succeeded
docs/modeling/media/family-definition-diagram.png ✅Succeeded
docs/modeling/media/family-map-property-decorator.png ✅Succeeded
docs/modeling/media/family-town-shape-map.png ✅Succeeded
docs/modeling/media/family-tree-model-sample.png ✅Succeeded
docs/modeling/media/family-tree-towns.png ✅Succeeded
docs/modeling/media/minimal-language-project-template.png ✅Succeeded
docs/modeling/media/tudors-family-tree.png ✅Succeeded
docs/modeling/modeling-sdk-for-visual-studio-domain-specific-languages.md ✅Succeeded
docs/modeling/validation-in-a-domain-specific-language.md ✅Succeeded

docs/modeling/media/family_class_diagram.png

  • Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/modeling/media/create-new-dsl-project.png

  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/modeling/media/dsl-solution-summary.png

  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 10104a9:

💡 Validation status: suggestions

File Status Preview URL Details
docs/modeling/media/create-new-dsl-project.png 💡Suggestion Details
docs/modeling/media/dsl-solution-summary.png 💡Suggestion Details
docs/modeling/getting-started-with-domain-specific-languages.md ✅Succeeded
docs/modeling/media/create-your-new-project.png ✅Succeeded
docs/modeling/media/define-new-model-file-type.png ✅Succeeded
docs/modeling/media/family-class-diagram.png ✅Succeeded
docs/modeling/media/family-definition-diagram.png ✅Succeeded
docs/modeling/media/family-map-property-decorator.png ✅Succeeded
docs/modeling/media/family-town-shape-map.png ✅Succeeded
docs/modeling/media/family-tree-model-sample.png ✅Succeeded
docs/modeling/media/family-tree-towns.png ✅Succeeded
docs/modeling/media/minimal-language-project-template.png ✅Succeeded
docs/modeling/media/tudors-family-tree.png ✅Succeeded
docs/modeling/modeling-sdk-for-visual-studio-domain-specific-languages.md ✅Succeeded
docs/modeling/validation-in-a-domain-specific-language.md ✅Succeeded

docs/modeling/media/create-new-dsl-project.png

  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/modeling/media/dsl-solution-summary.png

  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@prmerger-automator
Copy link
Contributor

PRMerger Results

Issue Description
Added File(s) This PR contains added files. New files require human review.
Changed Files This PR contains more than 10 changed files.
File Change Percent This PR contains file(s) with more than 30% file change.
Image File This PR added or updated an image file(s).

@prmerger-automator
Copy link
Contributor

PRMerger Results

Issue Description
Added File(s) This PR contains added files. New files require human review.
Changed Files This PR contains more than 10 changed files.
File Change Percent This PR contains file(s) with more than 30% file change.
Image File This PR added or updated an image file(s).

@marxlumon
Copy link
Contributor Author

#sign-off

@prmerger-automator
Copy link
Contributor

Invalid command: '#sign-off'. Only the assigned author of one or more file in this PR can sign off. @mgoertz-msft

You can make a wide variety of extensions to your DSL. The following examples will give you an impression of the possibilities.

After each change, save the DSL definition, click **Transform All Templates** in **Solution Explorer**, and then press **F5** to experiment with the changed DSL.
After each change, save the DSL definition, Click **Transform All T4 Templates** on the **Build** menu, and then press **F5** to experiment with the changed DSL.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Shouldn't "click" remain lower case since it's in the middle of a sentence?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sure. Fixed.

Copy link
Contributor

@mgoertz-msft mgoertz-msft left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. Adding @jekelly who now owns this for final review too.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit df67158:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File Status Preview URL Details
❌Error Details

  • [Error: CannotMergeCommit] Cannot merge commit df67158ed1ea0cd75637bb98748ffe4da30619dd in branch patch-2 of repository https://github.com/marxlumon/visualstudio-docs into branch main (commit ee3450eb9f68fbb69a8ac16329db207886090b03). Please follow this documentation: https://help.github.com/articles/resolving-a-merge-conflict-using-the-command-line/ to use git.exe to resolve you content conflicts locally and then push to remote.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@prmerger-automator
Copy link
Contributor

PRMerger Results

Issue Description
Added File(s) This PR contains added files. New files require human review.
Changed Files This PR contains more than 10 changed files.
File Change Percent This PR contains file(s) with more than 30% file change.
Image File This PR added or updated an image file(s).

@ghogen ghogen merged commit 4d3484d into MicrosoftDocs:main Jan 14, 2026
2 checks passed
@ghogen
Copy link
Collaborator

ghogen commented Jan 14, 2026

Merging now that it's been approved.

Thank you for the contribution, @marxlumon

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants