search

w3c / json-ld-bp

JSON-LD 1.1 Best Practices Note
https://w3c.github.io/json-ld-bp/
Other
21 stars 7 forks source link

Proposed renaming and sectioning #15

Closed BigBlueHat closed 4 years ago

BigBlueHat commented 4 years ago

I'd like to rename the BP to "JSON-LD Best Practices" (removing the 1.1), and break the sections up into:

ajs6f commented 4 years ago

What is the distinction between Authoring and Publishing? Is it in whether the context is being written or re-used?

BigBlueHat commented 4 years ago

Authoring would be about what goes into the JSON-LD document itself--i.e. @context ordering, when to use language/id maps, etc.

Publishing would be about putting that document someplace(s) for distribution--i.e. embedding in HTML, serving over HTTP, embedding in email, etc.

ajs6f commented 4 years ago

Okay. Would you be interested in breaking down Authoring to authoring contexts and authoring instance data?

BigBlueHat commented 4 years ago

Definitely. Good call.

BigBlueHat commented 4 years ago

I've updated the issue accordingly.