While I feel the need for “JSD” to be identifiably different from JSON Schema, there are some elements of JSON Schema that are clearly sensible and reusable. As such, the JSD specification may borrow from good practice that exists in any other applicable standard. Overall, the following principles will guide the definition of the JSD format:
- A JSD document should be valid JSON
- The schema for JSD documents should be describable using JSD
- Meta properties (e.g. schema identifiers) should be clearly distinguishable from other properties
- JSD documents should be able to reference other dependent JSD documents
- Unlike XSD, it will be possible to define the root of the schema
- JSD documents should be intuitive and simple to understand