- From: Ian B. Jacobs <ij@w3.org>
- Date: Tue, 17 Aug 2004 22:09:19 -0500
- To: www-qa@w3.org
- Message-Id: <1092798547.4402.298.camel@seabright>
Hi Olivier,
I just enjoyed a read-through of the 28 Jan 2003 "Chips" [1].
I have a couple of comments that I'll just sketch out here,
and if you plan to revise the document, we can talk about
them in more detail at that time.
Thanks!
_Ian
[1] http://www.w3.org/TR/2003/NOTE-chips-20030128/
=============================================================
1) It would be good to harmonize some of the terminology with
that used in the Architecture Document. For example,
"representation" rather than "instance of a resource". I think
there may even be some errors due to mixing resource and
representation. E.g., in section 1, "the HTTP Etag can be
shared by idential resources that have different URIs." I'm not
sure what that means.
Similarly, in section 5.2, the expression "request a URI" is
used; in the Arch Doc this would be "dereference a URI" (or
"request a representation of a resource").
Similarly, in 5.3.1, md5 sums are calculated on representations,
not resources.
2) I think the analogy at the beginning of section 1 needs work.
3) 1.1.1: Change "Use short URIs as much as possible" to something
like "Use short URIs" and then give the rationale as is done.
I think "as much as possible" doesn't add anything.
4) In Guideline 7, does it make sense to include a reference to
other negotiation specs such as CC/PP?
5) Guideline 8 feels out of place to me. This is guidance for
content authors, and the links in question are not (in practice
as far as I know) used by servers. Instead they are used by
some rare user agents. Does this guideline belong in Chips?
6) 9.1.1. It might be useful to provide some guidance to content
managers on when to use multiple choice v. when to pick one
representation and serve it. Are there familiar scenarios that
could be recounted?
7) 10.1.1. I think a reference to the Arch Doc here would be
useful. See, for example:
http://www.w3.org/TR/webarch/#metadata-inconsistencies
8) 10.2.II conflicts with the Architecture Document, which
says:
"In general, a representation provider SHOULD NOT specify the
character encoding for XML data in protocol headers since the
data is self-describing."
See http://www.w3.org/TR/webarch/#xml-media-types
9) 11.2.1: I can suggest another reason not to block indiscriminately:
it is unlikely that a server manager knows every single agent that
will be used to access the content, including some agents used by
people with disabilities.
10) Add a reference to the Arch Doc in the References section.
--
Ian Jacobs (ij@w3.org) http://www.w3.org/People/Jacobs
Tel: +1 718 260-9447
Received on Wednesday, 18 August 2004 03:09:48 UTC