W3C home > Mailing lists > Public > public-ddwg-comments@w3.org > April 2008

DDR Simple API - interpretation of getAPIVersion()

From: Rotan Hanrahan <rotan.hanrahan@mobileaware.com>
Date: Mon, 14 Apr 2008 06:22:20 -0400
Message-ID: <D5306DC72D165F488F56A9E43F2045D3018B104F@FTO.mobileaware.com>
To: <public-ddwg-comments@w3.org>

Regarding the getAPIVersion() method, described here:

http://www.w3.org/TR/2008/WD-DDR-Simple-API-20080404/#sec-Service-getAPI
Version

The definition says:

"Returns information about the implementation of the API including the
current version."

Our development team wish to know if this information is intended to be
machine readable. In the absence of a statement to this effect, the only
valid interpretation is that the returned String is intended to be read
by a human, presumably for diagnostics purposes.

Proposed amendment:

The team also notes that in addition to getting diagnostic information
about the API implemented by an instance, it may also be of benefit to
get a machine-readable indication of the API to which the implementation
claims conformance. The proposal is to add a method:

  Public String getAPINamespace();

In the case of this API, the returned value would be:

  "http://www.w3.org/TR/DDR-Simple-API/"

On behalf of MobileAware Ltd, Development Team,

Dr Rotan Hanrahan
Chief Innovations Architect
MobileAware
Received on Monday, 14 April 2008 10:23:00 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 19:41:40 UTC