"Every JSON object in an Activity Streams 2.0 document is either an Object or a Link"

[evanp]

Section 4 says, in part:

Every JSON object in an Activity Streams 2.0 document is either an Object or a Link.

This probably isn't true. For example, this document includes an object that's a vcard:Address:

{
  "@context": "https://www.w3.org/ns/activitystreams",
  "type": "Place",
  "id": "https://places.pub/way/132605490",
  "to": "as:Public",
  "name": "DNA Lounge",
  "vcard:hasAddress": {
    "type": "vcard:Address",
    "vcard:street-address": "375 11th Street",
    "vcard:locality": "San Francisco",
    "vcard:postal-code": "94103"
  }
}

This one has an object that is a sec:Key:

{
  "@context": [
      "https://www.w3.org/ns/activitystreams",
      "https://w3id.org/security/v1"
  ],
  "type": "Person",
  "id": "https://example.com/user/aaaaa",
  "to": "as:Public",
  "name": "AAAAA",
  "publicKey": {
    "type": "CryptographicKey",
    "publicKeyPem": "<key data>"
  }
}

Is there another way to make the point in this sentence ("Object and Link are the root types in the AS2 type hierarchy") that is clearer?

[trwnh]

(small note: CryptographicKey expands against the security/v1 context into sec:Key and not sec:CryptographicKey)

In any case, I think the quoted bit is meant to be read in conjunction with the immediately following paragraph about when something is a Link. The assumption seems to be that everything is an as:Object by default, even JSON objects described exclusively using external vocabularies? I'm not sure this holds up well, but it would seem to imply a media type processing consideration to inject type statements about certain nodes...

Given an input document of the following form:

{
  "@context": "https://www.w3.org/ns/activitystreams",
  "type": "Place",
  "id": "https://places.pub/way/132605490",
  "to": "as:Public",
  "name": "DNA Lounge",
  "vcard:hasAddress": {
    "type": "vcard:Address",
    "vcard:street-address": "375 11th Street",
    "vcard:locality": "San Francisco",
    "vcard:postal-code": "94103"
  }
}

then do we say that seeing this:

Content-Type: application/activity+json

should then inject a statement that results in the following document?

{
  "@context": "https://www.w3.org/ns/activitystreams",
  "type": "Place",
  "id": "https://places.pub/way/132605490",
  "to": "as:Public",
  "name": "DNA Lounge",
  "vcard:hasAddress": {
    "type": ["vcard:Address", "Object"],
    "vcard:street-address": "375 11th Street",
    "vcard:locality": "San Francisco",
    "vcard:postal-code": "94103"
  }
}

I'm not sure this is necessary or even useful...

[evanp]

I think this sentence doesn't add anything to the document, is questionable. We could just leave it out and the next sentence makes sense and is useful.