Re: Link relation types for non-GET links

Erik Wilde <dret@berkeley.edu> Sat, 15 August 2015 14:13 UTC

Return-Path: <dret@berkeley.edu>
X-Original-To: link-relations@ietfa.amsl.com
Delivered-To: link-relations@ietfa.amsl.com
Received: from localhost (ietfa.amsl.com [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 205611A00ED for <link-relations@ietfa.amsl.com>; Sat, 15 Aug 2015 07:13:43 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -4.211
X-Spam-Level:
X-Spam-Status: No, score=-4.211 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_MED=-2.3, SPF_PASS=-0.001, T_RP_MATCHES_RCVD=-0.01] autolearn=ham
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id tsUcxVUqF4z4 for <link-relations@ietfa.amsl.com>; Sat, 15 Aug 2015 07:13:41 -0700 (PDT)
Received: from cm03fe.IST.Berkeley.EDU (cm03fe.IST.Berkeley.EDU [169.229.218.144]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id ADFBF1A00E2 for <link-relations@ietf.org>; Sat, 15 Aug 2015 07:13:41 -0700 (PDT)
Received: from 205-237-53-208.static.cgocable.ca ([205.237.53.208] helo=dretair11.local) by cm03fe.ist.berkeley.edu with esmtpsa (TLSv1:AES128-SHA:128) (Exim 4.76) (auth plain:dret@berkeley.edu) (envelope-from <dret@berkeley.edu>) id 1ZQcDL-0005aY-Bn; Sat, 15 Aug 2015 07:13:40 -0700
Message-ID: <55CF4910.20109@berkeley.edu>
Date: Sat, 15 Aug 2015 10:13:36 -0400
From: Erik Wilde <dret@berkeley.edu>
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.10; rv:31.0) Gecko/20100101 Thunderbird/31.6.0
MIME-Version: 1.0
To: link-relations@ietf.org
Subject: Re: Link relation types for non-GET links
References: <CAAzbHvb==Sn_4UUFHKs3H9GYbEfiX=TUjv4FSmNi9R4NEB+DvQ@mail.gmail.com> <CANqiZJZ-JwFi8DLGE1iBp9t88KYcE=y=vsPr5EEQ6bYuA96Kxw@mail.gmail.com> <CAAzbHvY=e3yFdP4tjR7EMvksE+gJDt+t6CpzfG0A1G=ZVusGpg@mail.gmail.com>
In-Reply-To: <CAAzbHvY=e3yFdP4tjR7EMvksE+gJDt+t6CpzfG0A1G=ZVusGpg@mail.gmail.com>
Content-Type: text/plain; charset="windows-1252"; format="flowed"
Content-Transfer-Encoding: 7bit
Archived-At: <http://mailarchive.ietf.org/arch/msg/link-relations/SPVZCz8kPre4dB3q58VGtKJQUww>
X-BeenThere: link-relations@ietf.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: <link-relations.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/link-relations>, <mailto:link-relations-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/link-relations/>
List-Post: <mailto:link-relations@ietf.org>
List-Help: <mailto:link-relations-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/link-relations>, <mailto:link-relations-request@ietf.org?subject=subscribe>
X-List-Received-Date: Sat, 15 Aug 2015 14:13:43 -0000

hello mike and klaus.

On 2015-08-15 08:27, Klaus Hartke wrote:
> Mike Kelly wrote:
>> You can use a standard HAL link and a link relation if you ensure the link
>> relation is a URL which can be dereferenced to retrieve a machine-readable
>> description of the methods and messages that are possible for that link.
>> Just think of it as machine readable link relation documentation.
> That's an interesting idea. It basically adds a level of indirection,
> which should be useful if many links have the same machine-readable
> description of possible methods and payloads. However, I think I'd
> prefer including that description directly at the link, so a client
> does not have to dereference a URL to understand the link semantics.

if you have a standalone format (such as 
https://github.com/dret/I-D/tree/master/link-desc or whatever you come 
up with to represent link interaction information), then embedding it or 
making it external or allowing both is a simple design choice and flip 
for anybody using it.

our main driver for allowing this kind of flexibility was the scenario 
mentioned before: the general link relation type might define a number 
of parameters clients can submit, but the specific runtime info could be 
more constrained ("only 42 pages you can GET"), and clients could adjust 
accordingly. ideally, there would be some kind of "inheritance model" 
(effective link interaction semantics are a combination of the generic 
ones, and runtime info can selectively overwrite), but we never got far 
enough to really have a well-defined model for that.

cheers,

dret.

-- 
erik wilde | mailto:dret@berkeley.edu  -  tel:+1-510-2061079 |
            | UC Berkeley  -  School of Information (ISchool) |
            | http://dret.net/netdret http://twitter.com/dret |