activitystreams icon indicating copy to clipboard operation
activitystreams copied to clipboard

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

Open zimeon opened this issue 2 years ago • 3 comments

Please Indicate One:

  • [x] Editorial
  • [ ] Question
  • [ ] Feedback
  • [ ] Blocking Issue
  • [ ] Non-Blocking Issue

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

zimeon avatar Aug 25 '22 17:08 zimeon

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"

gobengo avatar Aug 02 '23 16:08 gobengo

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 avatar Aug 02 '23 16:08 evanp

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

evanp avatar Aug 02 '23 16:08 evanp