Use of describedby link relation

"Markus Lanthaler" <markus.lanthaler@gmx.net> Thu, 15 November 2012 12:59 UTC

From: Markus Lanthaler <markus.lanthaler@gmx.net>
To: link-relations@ietf.org
Subject: Use of describedby link relation
Date: Thu, 15 Nov 2012 13:58:26 +0100
Message-ID: <010001cdc330$e75a1720$b60e4560$@lanthaler>
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Content-Language: de
Thread-Index: Ac3DMOasmSzqsMCeTE2qwnU85+AuBQ==
Precedence: list

Hi,

I have a question regarding the use of the describedby link relation.

In JSON-LD [1] we have something that we call a "context". Its purpose is
mainly to map terms to IRIs to allow their unambiguous identification. In a
JSON-LD document that context is stored in a "@context" property like so:

{
  "@context": {
    "name": "http://example.com/name"
  },
  "name": "Markus Lanthaler"
}

To allow developers to build on existing infrastructure, i.e., keep their
JSON documents unchanged but nevertheless allow them to link to such a
"context" we use a HTTP link header with the relation type "descibedby" [2]:

Link: <http://json-ld.org/contexts/person.jsonld>; rel="describedby";
type="application/ld+json"

We now got some complaints [3] that we are abusing "describedby" since a) we
are not linking to POWDER documents, and b) the way we use it doesn't match
the semantics of that link relation.


I would appreciate your opinion on that. Do you think we should mint a new
link relation or is it a sensible decision to use "describedby" for this!?



Thank you very much,
Markus


[1] http://json-ld.org/
[2]
http://json-ld.org/spec/latest/json-ld-syntax/#referencing-contexts-from-jso
n-documents
[3] https://github.com/json-ld/json-ld.org/issues/197



--
Markus Lanthaler
@markuslanthaler

Use of describedby link relation Markus Lanthaler
Re: Use of describedby link relation Mark Nottingham
RE: Use of describedby link relation Markus Lanthaler