Re: [xri] RE: Proposed changes to CD01

[Will Norris <will@willnorris.com>]

A few comments inline.  Probably worth discussing on the call tomorrow.


On Nov 15, 2009, at 2:26 PM, Eran Hammer-Lahav wrote:

> Please review.
> 
>> * Clarify <Alias> definition to express that the element does NOT extend the subject of the XRD and is only used to describe the subject resource
> 
> Text now reads:
> 
>        This URI value provides an additional identifier for the resource described by the XRD.  This value
>        MUST be an absolute URI.  The <Alias> element does not extend the subject of the XRD. It is only used
>        to provide other identifiers the subject resource can also be identified by.

Have people actually been confused as to the purpose of the Alias element, or is this just preventative?


>> * Add text to <Subject> to make its design restrictions more explicit
> 
> Added to the introduction:
> 
>    The XRD schema is optimized for describing a single resource identified with a URI, as reflected by the
>    definition of the <Subject> element. This design does not limit the
>    applicability of the XRD schema from describing other classes of resources. This can be accomplished by
>    by defining new extension elements capable to identifying different subject types.

Would it be sufficient to just add a sentence to Section 2.1.3 along the lines of: "If <Subject> is not specified, it is expected that the resource described by this XRD will be identified by other means." ?


> And small changes to text about link selection:
> 
>    <snip>
> 
>    Selection based on multiple criteria can be handled by performing multiple selections. Each selection is
>    assigned preference order based on the consumer's needs. The selection results are compared to determine
>    the most desired set. For example, a consumer processing an XRD describing a article, is looking for
>    links to resources about the author, and giving higher preference to HTML documents over plain text, will
>    perform two selection rounds, one for links with the 'author' relation type and another for choosing the
>    most appropriate link is more than one is found.

This last sentence is a bit confusing.  I'll go ahead and tweak it a bit.


Also, the phrase "subject resource" was added in two places to refer to what is elsewhere called the "resource described by the XRD".  That's the first time this phrase has been used, so I'm a little concerned about consistency.

-will