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

Suggest slight change in description of Slug




I think 9.7 is subtly wrong. I discovered this when I was shaking down the Ape's interaction with Joe's apptest server. I sent a slug along and it didn't show up in the Member URI, so I complained. I talked to Joe and found that we agreed that the whole point of "slug" is to affect the URI the world sees, not the one your editor sees. So you'd want the URI that you find in the <link rel="alt"/> to have the slug in it.

So I would propose that 9.7 be re-written as follows:

=============================
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.

Servers MAY use the value of the Slug header when creating the URI normally used to retrieve the newly-created resource, for instance by using some or all of the words in the value for the last URI segment. Servers MAY also use the value when creating the atom:id or as the title of a Media Link Entry (see Section 9.6.).
==============================

Also then it would be nice if the example in 9.2.1 got a <link rel="alt" that used the slug.

 -Tim