- From: Susan Lesch <lesch@w3.org>
- Date: Wed, 7 Feb 2001 21:56:02 -0800
- To: www-style@w3.org
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