[AS2] Deprecate "url" in favor of "id" and "self" link relations

• From: James M Snell <jasnell@gmail.com>
• Date: Thu, 21 Aug 2014 09:16:20 -0700
• To: "public-socialweb@w3.org" <public-socialweb@w3.org>, "activity-streams@googlegroups.com" <activity-streams@googlegroups.com>
• Message-ID: <CABP7RbeecADNuNxibLbZqi0=Y1L4i8zALAkwKScKfARO1uLPgA@mail.gmail.com>

In an activity streams document, the "url" property is typically used
to point to a displayable (typically HTML) representation of an
object. The "id" property is typically used to provide just an
identifier. With AS2's direct incorporation of IANA Link Relations, it
makes more sense to deprecate the use of "url" in favor of link
relations such as "self" or "alternate". Doing so simplifies things a
bit more and gives us better alignment with things like JSON-LD.

The change is fairly simple:

  {
    "objectType": "note",
    "url": "http://example.org/foo"
  }

Becomes

  {
    "objectType": "note",
    "self": "http://example.org/foo"
  }

In the AS2 document, the "url" property would be listed as deprecated
and treated as an alias for "self".

Thoughts?

- James

Received on Thursday, 21 August 2014 16:17:08 UTC