Skip to content
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

JSON Hyper-Schema - incorrect reference to JSON Schema core #2

Open
hrennau opened this issue Jan 4, 2020 · 1 comment
Open

JSON Hyper-Schema - incorrect reference to JSON Schema core #2

hrennau opened this issue Jan 4, 2020 · 1 comment

Comments

@hrennau
Copy link

hrennau commented Jan 4, 2020

Document:
https://json-schema.org/draft/2019-09/json-schema-hypermedia.html

Issue: In several places, e.g.
https://json-schema.org/draft/2019-09/json-schema-hypermedia.html#rfc.section.6.1
(section 6.1, first paragraph)

an erroneous reference to the JSON Schema core specification is made:
"Section 3.1 of the JSON Schema core specification)"

The referenced document:
https://tools.ietf.org/html/draft-handrews-json-schema-02

has a section 3, but no section 3.1. This is quite relevant, because the reference is really needed in order to elucidate facts hinted at, but not really explained (e.g. "the link's context resource is, by default, the sub-instance to which it is attached (as defined by ...). This is often not the entire instance document." Interestingly, the term "sub-instance" is not used at all in the core specification, therefore it is not clear what "the sub-instance to which it is attached" means.

@handrews
Copy link
Contributor

Blah. By the time we finally got core and validation in shape I was way too burnt out to catch these sort of things in Hyper-Schema. Thanks!

@philsturgeon philsturgeon transferred this issue from json-schema-org/json-schema-spec Jan 15, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants