W3C home > Mailing lists > Public > public-vocabs@w3.org > March 2012

xyzURL case spelling - ISSUE-9: Naming url properties

From: Dan Brickley <danbri@danbri.org>
Date: Fri, 9 Mar 2012 21:59:43 +0100
Message-ID: <CAFfrAFo87Eo5u0M+W37JvwoiNi0o+RZcbPKf6docjWSLWoWr9Q@mail.gmail.com>
To: public-vocabs@w3.org
The schema.org partners discussed today the issue tracked as 'ISSUE-9:
Naming url properties'

Currently we have: a class http://schema.org/URL; alongside the
following properties: url, embedURL, contentURL, downloadURL,
thumbnailUrl, replyToUrl, discussionUrl.

This variety has been causing confusion, particularly around
VideoObject, for which many of these properties are applicable.

We resolved that - given current variety of case spellings - looking
to the future we will prefer camelCase for multi-word properties that
reference URLs/urls.  As with other properties, the initial letter of
the word or phrase is lower case, and the letter 'U', "r', 'l', are
written e.g. "xyzUrl" rather than "xyzURL".

At some point we will therefore add new preferred forms for three of
these: embedUrl (for embedURL), contentUrl (for contentURL),
downloadUrl (for downloadURL). Consumers should still consume the
earlier variants too. This continues our general practice of avoiding
hard 'deprecation', although you can expect the Web site to start to
nudge publishers towards the preferred form. The schema.org site won't
change to reflect this directly, but I wanted to drop a note here to
report the decision immediately. We'll figure out a way of making
these aliases / synonyms available in machine form, as well as a human
readable summary.


Received on Friday, 9 March 2012 21:00:11 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:29:22 UTC