raml-org / raml-spec

RAML Specification
http://raml.org
3.87k stars 858 forks source link

Clarify how to process JSON-formatted data structures without a $schema key #755

Closed jstoiko closed 3 years ago

jstoiko commented 3 years ago

As discussed in #751.

GauthierPLM commented 3 years ago

I think adding a link to a reference explaining why JSON is also a valid YAML 1.2 would be helpful for readers. People might have not heard of this before and not understand it without additional research. Having a reference would ensure this is sourced and indeed a spec the reader can refer to.

FYI, I never heard about this before and discovered while reading this PR.

jstoiko commented 3 years ago

Thanks for the note @GauthierPLM. It's in the YAML 1.2 spec, both in the initial introduction and "1.3 Relation to JSON" sections.