W3C home > Mailing lists > Public > public-earl10-comments@w3.org > May 2011

Bug 013: Inconsistent Naming

From: Sean B. Palmer <sean@miscoranda.com>
Date: Wed, 11 May 2011 13:14:04 +0100
Message-ID: <BANLkTi=HH_ymhpHxjNaqjhw94JG7D6u5vA@mail.gmail.com>
To: public-earl10-comments@w3.org
This is feedback on a Last Call Working Draft:

Evaluation and Report Language (EARL) 1.0 Schema
W3C Working Draft 10 May 2011
http://www.w3.org/TR/2011/WD-EARL10-Schema-20110510/

The earl:assertedBy property is named in an adpositional manner
whereas all of the other properties, e.g. earl:subject, earl:result,
earl:info, use a role nouns. Change earl:assertedBy to earl:assertor
for consistency.

In the early EARL model, earl:assertedBy only existed in its inverse
form, which was called earl:asserts. For consistency that would now be
called earl:assertion of course, but the inverse is used now anyway.

There has historically been some debate as to whether noun roles or
phrasal property names are better. Some further reading on this issue
includes:

http://www.w3.org/wiki/RoleNoun
http://www.jenitennison.com/blog/node/128

The consensus has always tended towards role nouns except very early
on, and this is reflected in EARL's predominant use of role nouns
except in the case of earl:assertedBy.

-- 
Sean B. Palmer, http://inamidst.com/sbp/
Received on Wednesday, 11 May 2011 12:14:32 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 11 May 2011 12:14:32 GMT