Conversation
|
I am new to this project and to JSON schemas, but it seems you did a very through job. I am was surprised to see all the APIs and types (APIRefs) listed in the schema. I guess it depends on how we intend the schema. If we want the schema to be "a priori", i.e. a Otherwise if we want the schema to be "a posteriori", then this schema should be auto-generated from the A middle ground might be best: a manually maintained "a priori" schema (without types and APIs enums) and auto-generated metadata files that list the possible values. These metadata files may contain all sort of useful information (for example a map of symbols) and might spare projection maintainers some work. |
This is my first time making a json schema, so I'm sure there's plenty to be improved. I used
check-jsonschemato test that the schema was correct. The command I used wascheck-jsonschema --schemafile schema.json api/*.jsonThis doesn't make sure that everything is covered under the schema, only that the schema is correct for the parts that have been added.