Comments on TAG finding "The use of Metadata in URIs"

Hi Noah and Stuart,

Congrats on your recent TAG finding [1] "The use of Metadata in URIs".
I had the pleasure of reading it today and found it very helpful.
I have a couple of comments that I thought I would send to you for
your consideration. 

Best,

 - Ian

1) I think it might be useful to list the constraints and
   good practices up front, just before the Introduction.

2) I expected something like a constraint or good practice
   note at the end of section 2.2. This seems to be an important
   message that we need to communicate: Read meaning into
   metadata at your own risk! It may be legitimate to 
   call this a constraint:

    Constraint: Individuals who read meaning into URIs that
    is not licensed by specification take responsibility
    for doing so.

   That may not be the ideal formulation, but I think there
   should be a similar statement that stands out more.

 3) Minor editorial: In para 4 of 2.3, you write:
    "HTML forms and now XForms each provide..." I think
    "both provide" might be preferable; I expect "provides"
    after "each".

 4) Minor editorial: the last paragraph of section 2.3 
    suddenly switches to "you" instead of the third person
    (e.g., "users"). Also, I recommend "cannot" instead of
    the informal "can't."

 5) I think it might be interesting to provide the example
    of how W3C uses dates in URIs in section 2.4. We use
    dates to make it easier to avoid steps on our toes
    when minting URIs, and to help us (internally) find
    information. [You refer to "creation date" in the
    conclusions; mentioning dates in 2.4 would make that
    comment more meaningful.]

 6) In section 2.5, you've almost made the case when
    2 URIs for the same resource might be ok: when you
    want one that's friendly for the public, and one
    that's useful internally. The Arch Doc (as I recall)
    says to avoid this, but is it ok to mint URIs when
    you wish to please 2 audiences?

 7) It was brought to my attention that in the list of
    references, there are some spaces missing after some
    initials (e.g., "R. T. Fielding" and "I. Jacobs").
    

[1] http://www.w3.org/2001/tag/doc/metaDataInURI-31.html

-- 
Ian Jacobs (ij@w3.org)   http://www.w3.org/People/Jacobs
Tel:                     +1 718 260-9447

Received on Friday, 5 January 2007 00:16:59 UTC