search

json-ld / yaml-ld

CG specification for YAML-LD and UCR
https://json-ld.github.io/yaml-ld/spec
Other
19 stars 8 forks source link

Update YAML reference to 1.2.2, addressing references to "YAML stream". #64

Closed gkellogg closed 1 year ago

gkellogg commented 1 year ago

Note that the title was changed to "YAML Ain’t Markup Language (YAML™) version 1.2.2" from "YAML Ain’t Markup Language (YAML™) version 1.2". Arguably, we should be using [[YAML122]] to be more explicit, and should probably note something about 1.2.2 being the minimum version supported.

Fixes #61.

Preview | Diff

TallTed commented 1 year ago

Yes, I think this does mean some additional edits are needed of the part where the doc says "YAML-LD is not bound to any specific version of YAML, though this doc is based on 1.2.2", which implies that earlier as well as newer versions of YAML can be used for YAML-LD.

gkellogg commented 1 year ago

Yes, I think this does mean some additional edits are needed of the part where the doc says "YAML-LD is not bound to any specific version of YAML, though this doc is based on 1.2.2", which implies that earlier as well as newer versions of YAML can be used for YAML-LD.

I'm not sure that updating the YAML reference affects this. It may mean that the concept of "YAML streams" is not appropriate if using an earlier version of the spec, but that doesn't really change the way people would interpret this document if using an older version of YAML.

TallTed commented 1 year ago

Ah, I see... So the need is more for bit of prose along the lines of "YAML streams were introduced in YAML 1.2.2, and cannot be used in earlier versions" in the relevant section(s), more than a global.