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.
