[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Suggest slight change in description of Slug



* A. Pagaltzis <pagaltzis@xxxxxx> [2007-03-15 22:37]:
> * Tim Bray <Tim.Bray@xxxxxxx> [2007-03-15 21:20]:
> > Slug is a HTTP entity-header that when accompanying a POST to
> > a Collection, constitutes a request by the client that its
> > value be used as part of the URI normally used to retrieve
> > the to-be-created Member Resource.
> 
> That section of the spec has always read rather clunkily to me,
> and while I am in favour of your qualification, it really
> pushes the sentence into “barely-parsable” territory. How about
> the following?
> 
>     Slug is an HTTP entity-header whose presence in a POST to a
>     Collection constitutes a request by the client to use the
>     header value as part of the URI of the to-be-created Member
>     Resource.
> 
> I think that will tie fewer brains in knots. :-)

*grmf* And then I went and accidentally dropped the specific
qualification from the text. What I meant is, of course, this:

    Slug is an HTTP entity-header whose presence in a POST to a
    Collection constitutes a request by the client to use the
    header value as part of the URI normally used to retrieve the
    to-be-created Member Resource.

Regards,
-- 
Aristotle Pagaltzis // <http://plasmasturm.org/>