[widgets] Editorial Comments on 18-Aug-2009 LCWD of A&E spec

A few editorial comments on Sections 1-3 of the 18-August-2009 LCWD  
of the A&E spec:

  http://www.w3.org/TR/2009/WD-widgets-apis-20090818/

-Regards, Art Barstow

1. Section 1: given this spec does no longer includes the  
notification methods, delete the following bullet:

[[
# and requests the user's attention in a device independent manner.
]]

(There is also a "programmbe" typo in the 1-Sep-2009 ED of the widget  
Interface spec.)

2. Section 1.1: since none of the documents in the list are  
Recommendations and hence by definition are subject to change, delete  
the list and replace it with a pointer to a non-normative "living  
document" (e.g. a wiki page).

3. Section 1.2: since [Widgets-Reqs] documents requirements but  
doesn't formally "address" any requirements, change "... are  
addressed ..." to "... are documented ...".

4. Section 1.2: I don't think the spec should enumerate stuff it does  
not define thus I would remove the "not addressed in this spec"  
paragraph and its list.

5. Section 2: change the order of the definitions to alphabetic ordering

6. Section 2: typo for Author script - should be "A script ..."

7. Section 2: Feature: this is defined in a Normative section but  
includes as part of its definition the non-normative "widgets spec  
family". Its definition should only use normative text.

8. Section 2: Viewport: The second sentence puts a normative  
requirement on the UA without any rationale. It also doesn't seem  
appropriate in the Definitions section (if at all in this spec).

9. Section 2: Getting and Setting: seems like there should a [Reference]

10. Section 2: Initialization: I don't understand this sentence,  
which when shortened is effectively "The first run through X, prior  
to runtime.".

11. Section 3: The preface "As well as sections marked as non- 
normative," isn't necessary.

Received on Wednesday, 9 September 2009 18:34:55 UTC