Allow those writing Azure Policy to document their config files like developers would document code with comments. Simply allow including "comment":{} and ignore it.

I would like to be able to do something like this:

"comment":{

"CreatedOn": "7/30/2020",

"Purpose": "Block changes that would take the configuration out of a state of compliance with policy XYZ",

"ItemsBlocked":[

    "Turning off logging",

    "Turning off https",

    "Turning on remote debugging"

],

"PointOfContact": "If you have concerns about this policy please contact the security and compliance team"

}