Skip to content

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

Open
@hrennau

Description

@hrennau

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions