search

json-ld / yaml-ld

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

Preliminary rules for discussion #34

Closed ioggstream closed 2 years ago

ioggstream commented 2 years ago

This PR

Preview | Diff

ioggstream commented 2 years ago

TODO: format examples

gkellogg commented 2 years ago

Thanks for taking a lead in this document @ioggstream.

gkellogg commented 2 years ago

The data-format="markdown" bits are a hack, but this can be cleaned up and formalized later, perhaps using some tabbed examples, as in the JSON-LD 1.1 specs.

ioggstream commented 2 years ago

Thanks Gregg. I need to learn how to "re-spec", but I think we can focus on the ideas for now :)

ioggstream commented 2 years ago

@TallTed Thanks for the first batch of suggestions! I merged all the ones that did not require further discussion.

gkellogg commented 2 years ago

Looks like Encoding Considerations use of data-cite needs to end with a fragment identifier, or use the [[YAML media type]] notation.

See <a data-cite="I-D.ietf-httpapi-yaml-mediatypes#">YAML media type</a>.

gkellogg commented 2 years ago

Note that data-cite is no longer recommended by ReSpec, and they suggest xref instead, but it doesn't seem to actually work with specs we reference.

ioggstream commented 2 years ago

Note that data-cite is no longer recommended by ReSpec, and they suggest xref instead, but it doesn't seem to actually work with specs we reference.

Filed #40

ioggstream commented 2 years ago

@gkellogg all set. Feel free to merge, now.

ioggstream commented 2 years ago

Rebased.

gkellogg commented 2 years ago

This PR was discussed in the 2022-07-06 meeting, and it was agreed to merge.