w3c / activitystreams

Activity Streams 2.0
https://www.w3.org/TR/activitystreams-core/
Other
281 stars 61 forks source link

Example 2.1.2 "Context with an object" is both wrong and misleading #524

Open zimeon opened 2 years ago

zimeon commented 2 years ago

Please Indicate One:

Please Describe the Issue:

The AS2.0 example 2.1.2 Context with an object is both wrong and misleading. That is it wrong has already been pointed out in https://github.com/w3c/activitystreams/issues/510 but I'm creating a new issue because the problem is deeper than suggested there. The problem is that the suggested use of @vocab to map terms into the AS namespace (even if a # is added per https://github.com/w3c/activitystreams/issues/510) is not a substitute for specifying the AS context. For example, the @vocab will happily map type to https://www.w3.org/ns/activitystreamstype (or https://www.w3.org/ns/activitystreams#type if a # is added) but the AS context actually maps type to @type

gobengo commented 1 year ago

I agree we should append '#' to the value of @vocab in example 2.1.2

https://json-ld.org/playground/#startTab=tab-expanded&json-ld=%7B%22%40context%22%3A%7B%22%40vocab%22%3A%22https%3A%2F%2Fwww.w3.org%2Fns%2Factivitystreams%22%2C%22ext%22%3A%22https%3A%2F%2Fcanine-extension.example%2Fterms%2F%22%2C%22%40language%22%3A%22en%22%7D%2C%22summary%22%3A%22A%20note%22%2C%22type%22%3A%22Note%22%2C%22content%22%3A%22My%20dog%20has%20fleas.%22%2C%22ext%3Anose%22%3A0%2C%22ext%3Asmell%22%3A%22terrible%22%7D

^ this is the example as it is today, and it shows how without the #, the flatteened LD ends up as "https://www.w3.org/ns/activitystreamscontent"

evanp commented 1 year ago

We should include a note in the Errata for this example specifying that the @vocab term should be its equivalent with the hash at the end.

evanp commented 1 year ago

I added the note to the Errata, and we can confirm with the larger group.