"Azure Policy definition structure basics" JSON example doesn't validate

[jpluscplusm]

I'm using the page https://learn.microsoft.com/en-gb/azure/governance/policy/concepts/definition-structure-basics to learn about Azure policy definitions.

The page contains an example of a JSON policy definition, directly under the text "For example, the following JSON shows a policy that limits where resources are deployed".

Directly underneath that example JSON, there's a sentence ("For more information, go to the policy definition schema") that links to a JSON Schema describing a "policy definition" (https://schema.management.azure.com/schemas/2020-10-01/policyDefinition.json)

Here's the problem: the example JSON presented on the page is invalid, according to the JSON Schema linked to by the page. I uploaded the schema and the example to an online validator (https://www.jsonschemavalidator.net/s/vKp4ApuY), which points out two high-level errors:

• Property properties has not been defined and the schema does not allow additional properties.
• Required properties are missing from object: if, then.

Requested fix: this page should be updated to link to an authoritative schema that can validate the example successfully.

[TPavanBalaji]

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

[TPavanBalaji]

@jpluscplusm Thank you for bringing this to our attention. I've delegated this to content author, who will review it and offer their insightful opinions.

[davidsmatlak]

Thank you for the documentation feedback. I created an internal backlog work item to review the issue. I'm closing the GitHub issue.

[davidsmatlak]

please-close

[jpluscplusm]

Thanks @davidsmatlak. Will this issue receive any updates as this problem gets addressed?