Comments for WD-css3-selectors-20010126

Here are some very minor comments for your CSS3 module: W3C selectors
Last Call Working Draft [1] based on one reading. A typo report may be
premature, I'm not sure. Most of all I enjoyed seeing the many examples
and that they are marked up so attractively without tables.

foo.com and somesite.com are registered domains. W3C recommends using
example.com, example.org, and example.net which IANA reserved for
examples. (see RFC 2606 section 3 at http://www.ietf.org/rfc/rfc2606.txt)

HTML Tidy (or another tool) with indentation turned off will remove
leading spaces in the source. This will reduce the file size by 8k.
(see http://www.w3.org/People/Raggett/tidy/)

In Status of this document, W3C organizations and maturity levels can
be capitalized as they are in the Process document: working group ->
Working Group, last call -> Last Call, style activity -> Style
Activity, working draft -> Working Draft.
(see http://www.w3.org/Consortium/Process/)


Unicode names
=============

It would be a good idea to call characters by their Unicode names;
(see http://www.unicode.org/charts/PDF/U0000.pdf). That would entail
these changes:

In 6.4 par. 1, follow the ".". -> follow the period (.).
[or "full stop"]

In 8.2, the ">" character -> the greater-than sign (>)

In 8.3.1, the "+" character -> the plus sign (+)

In 8.3.2, the "~" character -> the tilde (~)


Globally
========

whitespace and white-space -> white space
(see http://www.w3.org/TR/REC-xml#sec-white-space)

stylesheets -> style sheets

Element and attribute names could be marked up <code>.

Example(s): could read Example: when there is only one, and
Examples: when there are more.

Some references link to CSS2. [RFC1766], [HTML40], [YACC] and
[FLEX] could be added to section 16, with links changed to
local anchors.

In 7.1, if you want to use HTML rather than XHTML, why not
HTML 4.01?


Extra white space?
==================

In 7.1, the examples introduce white space between fictional
tag sequences. For example I think:

<p::first-line> This is a somewhat long HTML paragraph that will 
</p::first-line>

would read:

<p::first-line>This is a somewhat long HTML
paragraph that will</p::first-line>

Same thing in 7.2 plus extra space inside paragraphs:

<P><SPAN>The first</SPAN> few words of an article
     in The Economist.</P>

illustrated as (also note lowercase "the"):

<P>
<SPAN>
<P::first-letter>
T
</P::first-letter>he first
</SPAN>
few words of an article in the Economist.
</P>

would be:

<P><SPAN><P::first-letter>T</P::first-letter>he first</SPAN>
few words of an article in The Economist.</P>


Minor typos
===========

From here down, a section number is followed by a quote and then
a suggestion.

1. par. 2
behaviours
behaviors

syntax. For instance behaviours or tree transformations.
syntax, for instance behaviors or tree transformations.

1. par. 3
     These tests are not conformance full tests but intent to provide
     users with a way to check if a part of this specification is
     implemented at least a minima or not or, on the contrary, not
     implemented at all.
could read:
     These tests are not full conformance tests but are intended to
     provide users with a way to check if a part of this specification
     is implemented a [ad?] minima or is not implemented at all.

1.1 first sentence
CSS 2 Selectors and W3C Selectors
CSS 2 selectors and W3C selectors

are :
are:

1.1 second to last list item
independant
independent

2. table, E:target and 6.6.2 par. 3
refering URI
referring URI

2. last par.
derivated
derived

2. last par.
     Example: in CSS, the meaning of each selector is derivated from
     the table above prepending "matches" to the contents of each cell
     of the "Meaning" column.
[Why is this an example? It sounds like a statement of fact about the
table. I would omit this paragraph.]

4. par. 2
It always begin
It always begins
or, A sequence always begins

4. par. 3
content selector, pseudo-class
content selector, or pseudo-class

5. last par.
Warning :
Warning:

rule ; then
rule; then

6.1.1 Type selectors and Namespaces
Should explain and point to [Namespaces] with a normative reference,
Namespaces in XML.

6.1.1 par. 1
declared, in that case
declared. In that case

6.1.1 par. 3
in accordance with the standard error handling rules
[Needs a link to a reference for these rules.]

6.2 par. 1
see below Universal selector and Namespaces.
see Universal selector and Namespaces below.

6.2 par. 3
Warning :
Warning:

6.3.1 all examples
It was unclear to me when attribute values need to be in quotes.

6.3.1 fourth example
a a
an a

6.3.3 par. 1
Namespaces in the XML recommendation
Namespaces in XML Recommendation [Namespaces]

6.3.4 par. 2
explicitely
explicitly

6.4 last par.
but does not with class="pastoral blue"
but does not represent class="pastoral blue"

6.5 par. 1
them ; whatever
them; whatever

6.6 par. 1
Pseudo-class concept is
The pseudo-class concept is

6.6 par. 2
optionnaly
optionally

6.6 par. 3
or universal selector (eventually omitted)
[What does "eventually omitted" refer to? I don't think you mean
universal selector.]

6.6.1 par. 1
content; in principle
content, in principle

6.6.3 par. 1 and 2
[HTML40]
[HTML4] or [HTML401]

6.6.3 par. 1
XML:LANG
xml:lang

6.6.3 par. 2
Here is a C language code
[Where?]

6.6.4 par. 4
[UI] needs a link.

6.6.5 par. 3
dtd/scheme/namespace
[/ indicates a choice of two. Could read:]
DTD or schema and namespace

6.6.5 par. 4 and second example
colour
color

6.6.6 par. 5
unicode
Unicode

6.6.7 last par.
Note: the :not() pseudo allows to write useless selectors
Note: the :not() pseudo allows useless selectors to be written

7.1 second example
THIS IS A SOMEWHAT LONG HTML PARAGRAPH THAT
This is a somewhat long HTML paragraph that

In 7.2 first example, "The" for The Economist could be
capitalized in the illustration and in the fictional tag
sequence block.

7.2 par. 1
formetted
formatted

7.3 last par.
pseudo-elements:color
pseudo-elements: color

7.4 par. 1
Generated Content/Markers CSS 3 Module (module 14)
[needs a link and/or a References item]

9. last par.
is described in another CSS 3 Module "Cascade and Inheritance".
[needs a link and/or a References item]

10.1
some shorthand notations beyond Yacc (see [YACC]) is used:
some shorthand notations beyond Yacc (see [YACC]) are used:

In 10.1 the production for selector, pseudo_element contains a spacing
underscore. pseudoelement and pseudoclass don't; maybe they should.

11. pars. 1 and 4
web
Web

11. This sentence in list item 3 is too long:
     The XML document does not use a default namespace, all namespace
     prefixes used are known to the stylesheet author and there is a
     direct mapping between namespace prefixes and namespace URIs (a
     given prefix may only be mapped to one namespace URI throughout
     the XML document, there may be multiple prefixes mapped to the
     same URI).
could read:
     The XML document does not use a default namespace, all namespace
     prefixes used are known to the style sheet author, and there is a
     direct mapping between namespace prefixes and namespace URIs. (A
     given prefix may only be mapped to one namespace URI throughout
     the XML document. There may be multiple prefixes mapped to the
     same URI.)

12.
"Non normative example:" appears twice but there are no examples.
Also I would hyphenate that, "Non-normative."

15.
nov. 2000, and Electricité de France until feb. 2000
November 2000, and Electricité de France until February 2000

contributed to CSS 3 : David. L Baron
contributed to CSS 3: David L. Baron

Softquad
SoftQuad

16.2
Recommandation
Recommendation

[1] http://www.w3.org/TR/2001/WD-css3-selectors-20010126/

Best wishes for your project,

-- 
Susan Lesch - mailto:lesch@w3.org  tel:+1.858.483.4819
World Wide Web Consortium (W3C) - http://www.w3.org/

Received on Thursday, 8 February 2001 00:56:11 UTC