activitystreams
activitystreams copied to clipboard
Example 2.1.2 "Context with an object" is both wrong and misleading
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
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"
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.
I added the note to the Errata, and we can confirm with the larger group.