Align Policy JSON Schema & Examples with spec

[avatarneil]

Explain pull request

This PR is to resolve #599, which highlighted inconsistencies between the spec and JSONSchema definitions & examples. The approach taken was to leave the spec as-is (for now) in order to be non-breaking, and to update the JSONSchema definitions & examples to align with the spec in its current state.

Is this a breaking change

• No, not breaking

Impacted Spec

• policy

Additional context

For MDS 2.0, we may want to explore structuring this in accordance with the JSONAPI spec, e.g.

{
  "data": {
    "type": "policies",
    "attributes": {
     }
  }
},

[schnuerle]

Per our working group meeting this update was agreed upon. We will merge to dev by the end of the week.