[widgets] APIs and Events 1.0 draft comments

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 UTC