List of Property Definitions in "ActivityStreams 2.0 Terms" contains otherwise undocumented properties

[xenomachina]

Please Indicate One:

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

Please Describe the Issue:

ActivityStreams 2.0 Terms, in §3. Property Definitions, contains a list of AS2.0 property names, each of which links to its definition in Activity Vocabulary.

The following properties appear in this list, but have broken links:

• attachments
• author
• downstreamDuplicates
• orderedItems
• provider
• rating
• tags
• upstreamDuplicates
• verb

I searched in the following documents to see if I could find any mention of these properties:

• Activity Vocabulary
• Activity Streams 2.0
• ActivityPub
• JSON Activity Streams 1.0

Here's what I found:

1. The following properties are only mentioned in JSON Activity Streams 1.0:

   • attachments
   • author
   • provider
   • rating
   • tags

   They are not mentioned at all in any of the AS 2.0 documentation that I can see (except for this list). There are other properties in AS1.0 that were removed but which are not mentioned in this list.

   Suggested fix: remove these from the list.

2. The following properties...

   • downstreamDuplicates
   • verb
   • upstreamDuplicates

   ...are mentioned in Activity Streams 2.0, but only as being deprecated:

   This specification deprecates the upstreamDuplicates and downstreamDuplicates properties defined by Activity Streams 1.0 and does not provide a replacement.
   ...
   The terms displayName, verb, title and objectType should be treated as reserved terms that should not be used within Activity Streams 2.0 documents.

   There are other deprecated properties (like objectType) mentioned in the same place which are not mentioned in this list.

   Suggested fix: remove these from the list.

3. Finally, orderedItems is not mentioned in Activity Vocabulary except in examples.

   However, it is documented in Activity Streams 2.0 in §4.6 Collection.

   Suggested fix: update the link.

[xenomachina]

Also, given that orderedItems appears in this list, I wonder if:

• the object form of natural language properties, nameMap, summaryMap, and contentMap, should be added to this list
• preferredUsernameMap should be added to §4.1 ActivityPub.

[xenomachina]

This PR implements the proposed fixes from above.

[gobengo]

'as:attachment' and 'as:attachments' are both in the owl https://github.com/w3c/activitystreams/blob/master/vocabulary/activitystreams2.owl#L52

notably the referent of the @context URI does not mention attachments

bengo@bengo ~ ⚡  curl -H "Accept: application/json" https://www.w3.org/ns/activitystreams | grep attachment
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  7985  100  7985    0     0  18320      0 --:--:-- --:--:-- --:--:-- 18398
    "attachment": {
      "@id": "as:attachment",

ah but there is also this other file activitystreams1-context.jsonld that does define attachments https://github.com/w3c/activitystreams/blob/master/ns/activitystreams1-context.jsonld#L9C25-L9C25

[evanp]

@xenomachina this works pretty well. I think the principle that we should only include terms on this page that are defined in the context document is a righteous one.

We have a generator script in the GitHub repository. I'm going to re-run the script to make sure things compare correctly.

Since this is a non-normative document, we can make this change relatively easily.