-
Notifications
You must be signed in to change notification settings - Fork 37
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Update to JSON:API v1.1 #461
Conversation
…schema from RECOMMENDED and clarify the replacement field.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM now, thanks @rartino!
Workshop merge this, after fixing the comment above. |
This is now waiting for (re)reviews. |
Co-authored-by: Andrius Merkys <[email protected]>
Ping @ml-evs |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks @rartino!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Okay, I've just rebased this onto the links object PR, and fixed a bit of formatting. Perhaps @rartino can just double-check I haven't broken any content and we can get one more external re-reviews
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I've looked it trough, and it looks good to go.
Edit but looking through the formatted version, I think we are going to need a pre-release 1.2 PR to just clean up some other formatting in general.
Sure, we could start collecting them in #475? |
This is a set of changes that I think is what is needed (and useful) for updating the specification to JSON:API v1.1.
The primary reason I push for this is to be optionally allowed to include a top level "@context" to describe an OPTIMADE response as linked data as that is useful for #445. This is allowed in v1.1 but not in v1.0.
I've deprecated (but not removed) the old way of specifying a schema in favor of the more official JSON:API way.
I've consistently updated "JSON API" to "JSON:API" since that seems to be how it is supposed to be written.
I've also added documentation on a couple of OPTIONAL fields that arguably were already allowed from us adhering to JSON:API, but we've discussed is useful as we progress. E.g., the toplevel
jsonapi
to identify responses to be OPTIMADE responses.