search

SpaceApi / schema

SpaceAPI JSON schema files.
24 stars 14 forks source link

adds schema attribute #21

Closed gidsi closed 6 years ago

gidsi commented 6 years ago

The schema attribute should be provided to all schema files, more information can be found here and here

dbrgn commented 6 years ago

Maybe we should include draft-04/ in the URL?

gidsi commented 6 years ago

i was thinking about it, but 

"$schema": "http://json-schema.org/schema#"

is the "default" and refers to the latest stable standard (atm thats 06 and we're compatible with it). Its "what people do" according to the second link (haven't checked it myself).

From my personal view i would like to make an effort to keep up with it and stay compatible with the latest release instead of refering to an old one (which i would just do if we have a problem that we can't fix easily).

But switching the schema version whenever a new one comes out would work for me too.

dbrgn commented 6 years ago

As long as the standard stays reverse compatible, I'm fine with using the "plain" URL. But I'd specify the version against which we have tested our compatibility if possible.

dbrgn commented 6 years ago

Could you also update the README? It still says IETF draft 04 :)