search

MicrosoftDocs / azure-docs

Open source documentation of Microsoft Azure
https://docs.microsoft.com/azure
Creative Commons Attribution 4.0 International
10.09k stars 21.13k forks source link

Language Version 2.0 makes the documentation very much more difficult to understand #117450

Closed ronarieke closed 2 weeks ago

ronarieke commented 7 months ago

Please find me on Teams Ron.Rieke@microsoft.com The documentation for Azure Resource Manager, Create Templates, Modularize Templates refers to the URL azure-resource-manager/templates/linked-templates.

Linked Templates I understand fine, but this document talks about nested templates, modularized templates, and linked templates, and the naming scheme of the document is hard to find on search.

It would be a great way of introducing the new language mode, if it were more readily accessible, but also, introducing language version 2.0 remarks, such as: Important For languageVersion 2.0, the default value for the expressionEvaluationOptions property is inner. The value outer is blocked.

Are very confusing, because the default configurations for these versions appear different, and the reader is constantly interrupted with clarifications in the documentation.

I think the description of ARM V1 nested and linked templates, and ARM V2 modularized template implementation of linked templates and nested templates should be split up.

Thanks! Ron

Document Details

⚠ Do not edit this section. It is required for learn.microsoft.com ➟ GitHub issue linking.

AjayBathini-MSFT commented 7 months ago

@ronarieke Thanks for your feedback! We will investigate and update as appropriate.

AnuragSingh-MSFT commented 7 months ago

@ronarieke, thank you for the feedback. I am assigning it to our content team for further review.

@mumian, could you please review this feedback and share your thoughts, Thank you

mumian commented 2 weeks ago

@ronarieke - Hi Ron, thank you for your comments. I currently don't have any cycles for this request. This issue is tracked internally - https://dev.azure.com/msft-skilling/Content/_workitems/edit/265583.

please-close