search

ssilverman / rdm-schema

The schema for the Parameter Metadata Language from Section 5 of E1.37-5.
9 stars 3 forks source link

Versioning #11

Open peternewman opened 2 years ago

peternewman commented 2 years ago

Versioning. Perhaps we change the schema's $id each time there's an update? We could include the version in the URI. Some possibilities: https://estalink.us/schemas/v1.0.1/rdm-schema.json https://estalink.us/schemas/rdm-schema-v1.0.1.json

I'd favour the former example, you can then also have a symlink https://estalink.us/schemas/latest/rdm-schema.json which always points to the most recent version and the filename itself is always the same when downloaded, which is probably easier for software to manage (assuming the version is represented as a property within the JSON file too. I see it's currently in the id, it might be nice to have it duplicated as a clear semver field too, which doesn't require any fiddly parsing of the URL, although duplicating a value isn't great either.

ssilverman commented 2 years ago

JSON Schema doesn't have such a field. What do you propose?