W3C home > Mailing lists > Public > public-socialweb@w3.org > August 2014

[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
Message-ID: <CABP7RbeecADNuNxibLbZqi0=Y1L4i8zALAkwKScKfARO1uLPgA@mail.gmail.com>
To: "public-socialweb@w3.org" <public-socialweb@w3.org>, "activity-streams@googlegroups.com" <activity-streams@googlegroups.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

This archive was generated by hypermail 2.3.1 : Thursday, 8 December 2016 15:48:18 UTC