W3C home > Mailing lists > Public > public-webapps@w3.org > April to June 2009

[widgets] P&C Last Call comments, 3

From: Marcin Hanclik <Marcin.Hanclik@access-company.com>
Date: Mon, 1 Jun 2009 00:44:24 +0200
To: "public-webapps@w3.org" <public-webapps@w3.org>
Message-ID: <FAA1D89C5BAF1142A74AF116630A9F2C0A26D782DE@OBEEX01.obe.access-company.com>
EDITORIALs

8.3
Some general rule for how attributes are to be processed a user agent or conformance checker are also ...
should be
Some general rule for how attributes are to be processed by a user agent or a conformance checker are also ...

... given the processing rules that type of attribute.
should be
... given the processing rules for that type of attribute.

Version attribute
"The value of a version attribute is an arbitrary string (possibly empty) that denotes a software version identifier."
What is software?
8.5 says
version
    A version attribute that specifies the version of the widget. It is optional for authors to use this attribute.
Both shall be aligned.

Numeric attribute
a)
consists of one of more ...
should be
consists of one or more ...
b)
Maybe ABNF could help in this definition?

Keyword attribute
must not use case insensitive comparisons.
should be
must not use case-insensitive comparisons
[It would be good to perform a check for all "case-sensitive"/"case-insensitive" instances whether they are written in the same

manner.]

in which is it used, so the rule for hoe to retrieve
should be
in which iT iS used, so the rule for hoW to retrieve

Keyword list attribute
Maybe ABNF could help here?

An attribute defined as taking one or more keywords as values, which ...
should be
An attribute defined as taking one or more keywords as value, which ...

Boolean attribute
Maybe ABNF could help for true and false?
"... the feature element's..."
should be
"... the <feature> element's..."

Path attribute
A valid path is one that matches the the production ...
should be
A valid path is one that matches the production ...

A zip-abs-path is invalid in a the file name filed of a file entry.
should be
A zip-abs-path is invalid in the file name field of a file entry.

8.4
... primary language of an element, its attributes, and its descendent nodes.
should be
... primary language of an element, its attributes and its descendent nodes.

its:dir
i.e., ltr, or rtl, or lro, or rlo
should be
i.e., ltr, rtl, lro or rlo

8.5
view port
should be
viewport

"View port and view mode are defined in the [Widgets-Views] specification."
I cannot find the definition of either view port or viewport in [Widgets-Views].

8.7 and others
Starting always with "The ... element" or with "A/An ... element"? Just for consistency.

8.8
regardless of value of
should be
regardless of the value of

8.9
Localized license shouldn't be used
should be
Localized license should not be used

... the user agent should allow users the ability to view ...
should be
... the user agent should provide the users the ability to view ...

8.10
If the file pointed to by the src  attribute is a vector graphic format ...
could be
If the file pointed to by the src  attribute contains an icon in a vector graphic format ...

8.11
The allowed values are any name of a character set listed in ...
should be
The allowed value is any name of a character set from those listed in ...

(a user agent are required ...
should be
(the user agents are required ...

________________________________________

Access Systems Germany GmbH
Essener Strasse 5  |  D-46047 Oberhausen
HRB 13548 Amtsgericht Duisburg
Geschaeftsfuehrer: Michel Piquemal, Tomonori Watanabe, Yusuke Kanda

www.access-company.com

CONFIDENTIALITY NOTICE
This e-mail and any attachments hereto may contain information that is privileged or confidential, and is intended for use only by the
individual or entity to which it is addressed. Any disclosure, copying or distribution of the information by anyone else is strictly prohibited.
If you have received this document in error, please notify us promptly by responding to this e-mail. Thank you.
Received on Sunday, 31 May 2009 22:45:04 GMT

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