Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Clarify interoperable parsing expectations
As discovered through the OASComply project, certain referencing scenarios are ambiguous, with different authorities holding contradictory interpretations regarding whether and how they are to be supported. This particular scenario, where the same JSON/YAML object is parsed in different semantic contexts, is well-defined if the requirements of 2.0 are assumed to apply despite no longer appearing in the text. However, the scenario is *not* well-defined in 3.1, so we should advise against it. While the 3.1 version of this change made the scenario explicitly implementation-defined, it seems better to acknowledge the assumption here while still noting that it is not clearly required. This also removes the confusing reference to JSON Schema for "$ref" as the Reference Object *explicitly* states that it is governed by JSON Reference and *not* JSON Schema. It also enumerates more of the referencing keywords like we do in 3.1.
- Loading branch information