Update notes for submitted changes

* update jsonschema requirements to match reality