W3C home > Mailing lists > Public > public-webapps@w3.org > January to March 2009

[widgets] APIs and Events 1.0 draft comments

From: Jere Kapyaho <jere.kapyaho@nokia.com>
Date: Thu, 22 Jan 2009 18:05:57 +0200
To: public-webapps <public-webapps@w3.org>, ext Arve Bersvendsen <arveb@opera.com>
Message-ID: <C59E6605.4815%jere.kapyaho@nokia.com>

Hi Arve,

I looked briefly at the Widgets 1.0 APIs and Events spec, Working Draft 22
January 2009. Here are a couple of comments.

1.2 Terms and definitions
The definition of "widget context" is maybe a little bit too recursive to be
useful...

2.2 last sentence: 
"... meaning such an implementation MUST NOT allow separate widget instances
to" -- looks like this sentence is cut short.

2.3 The Widget interface
"The Widget interface provides functionality that is ." -- looks like this
is also cut short.

2.4 Members of the Widget interface
"The locale attribute [...] The value of the attribute MUST always be a
valid [ISO-639-2] language code." -- no, but a BCP 47 language tag.

"showNotification(message, callBack), method
The purpose of the

The showNotification() method accepts two arguments"
-- Missing the description of the method and the arguments.

Need to add the boilerplate statement about using RFC 2119 keywords, and
make the keyword markup consistent.

I can also help you with the References section if you like. That would also
allow you to fill in the inter-document links to the references.

Hope this helps.

--Jere
Received on Thursday, 22 January 2009 16:07:26 GMT

This archive was generated by hypermail 2.3.1 : Tuesday, 26 March 2013 18:49:29 GMT