W3C home > Mailing lists > Public > public-wai-ert@w3.org > December 2006

Re: HTTP Vocab, header property naming

From: Shadi Abou-Zahra <shadi@w3.org>
Date: Tue, 26 Dec 2006 13:50:14 +0100
Message-ID: <45911A86.6010803@w3.org>
To: Danny Ayers <danny.ayers@gmail.com>
Cc: public-wai-ert@w3.org

Hi Danny,

Thank you for your review comments, we will consider your suggestions. 
However, note that the names for the terms came from the respective RFCs 
and we didn't want to change too much (not even the camelBack notation).

We would be interested in your implementation experience, especially in 
information about an application that makes use of the vocabulary.


Danny Ayers wrote:
> Looking at the naming of the header properties, it seems to me that
> while e.g. "link" is the most concise local name for that property,
> and the machine can tell it's a subPropertyOf http:header, it would be
> clearer for the human reader were its name to make clear that it was a
> header, i.e. something like "link-header".
> Another (considerably less significant) reason this may be worth
> considering is that it may be desirable to use some of the header
> terms in a future version of the schema for non-header purposes:
> "public", "title", "position"... there are a lot of words with a
> meaning outside of the header context.
> I ran into the question in a practical context, playing with the
> vocabulary in Jena, there's a snag when using the schemagen tool [1]
> to generate a Java representation of the schema - two of the generated
> property names conflicted with Java keywords: if & public. I certainly
> don't think this inconvenience in itself is adequate justification for
> changing the vocab, but the general principle of favouring
> self-explanatory names could well be.
> See also: http://c2.com/cgi/wiki?MeaningfulName
> Cheers,
> Danny.
> [1] http://jena.sourceforge.net/how-to/schemagen.html

Shadi Abou-Zahra     Web Accessibility Specialist for Europe |
Chair & Staff Contact for the Evaluation and Repair Tools WG |
World Wide Web Consortium (W3C)           http://www.w3.org/ |
Web Accessibility Initiative (WAI),   http://www.w3.org/WAI/ |
WAI-TIES Project,                http://www.w3.org/WAI/TIES/ |
Evaluation and Repair Tools WG,    http://www.w3.org/WAI/ER/ |
2004, Route des Lucioles - 06560,  Sophia-Antipolis - France |
Voice: +33(0)4 92 38 50 64          Fax: +33(0)4 92 38 78 22 |
Received on Tuesday, 26 December 2006 12:50:40 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 17:52:53 UTC