W3C home > Mailing lists > Public > www-style@w3.org > February 2009

Re: [css3-multicol] Editorial Comments

From: Håkon Wium Lie <howcome@opera.com>
Date: Sun, 22 Feb 2009 22:55:34 +0100
Message-ID: <18849.51670.972841.478610@opera.com>
To: fantasai <fantasai.lists@inkedblade.net>
Cc: WWW Style <www-style@w3.org>
fantasai wrote, on 11 Dec 2007:

 > http://www.w3.org/TR/2007/WD-css3-multicol-20070606/
 > 
 > Overall, I suggest giving the property subsections some
 > kind of descriptive text in addition to the property name,
 > like in the CSS3 Text drafts:
 >    http://www.w3.org/TR/css3-text/

I'm unsure if that format increases readability in this case.

 > Dependencies on other modules
 > -----------------------------
 > 
 >    I think we can remove this section and maybe move
 >    the conformance section up front. You're already listing
 >    all the normative references in the References section.

The template document still prescribes a "Dependencies on other
modules" section:

  http://www.w3.org/Style/Group/css3-src/css3-template/Overview.html

I could probably support a change, shouldn't we change the template
first?

 > Introduction
 > ------------
 > 
 >    # By removing presentational table markup from documents
 >    # they can more easily be presented on various output
 >    # devices, including speech synthesizers and small mobile
 >    # devices.
 > 
 >    Change to
 > 
 >      | Removing presentation table markup from documents allows
 >      | them to more easily be presented on various output devices
 >      | including speech synthesizers and small mobile devices.

Good, done.

 >    Examples II and III should have some explanation of the expected
 >    results, just like Example I.

Added.

 >    # Finally, ‘column-fill’ and ‘column-span’ give style sheets
 >    # a wider range of visual expressions in multi-column layouts:
 > 
 >    I think this sentence is too vague to be useful to anyone. Not
 >    sure what to replace it with, though.

The section isn't normative, so I think it's ok.

 > 4.3 'columns'
 > -------------
 > 
 >    Remove the definition list and all but the first sentence of
 >    description. Then add
 >      | Omitted values are set to their initial values.
 > 
 >    which should take care of everything and is consistent with
 >    wording for other shorthand properties such as in the CSS3
 >    Backgrounds and Borders module.

That works.

 > 7.1 'column-span'
 > -----------------
 > 
 >    # Content in the normal flow that appear
 > 
 >    s/appear/appears/

Fixed.

 > 8. Filling columns
 > ------------------
 > 
 >    # UAs will try to balance content between different columns.
 > 
 >    s/will/must/

I used David Woolley's suggestion: "UAs should minimise the variation
in column length"

 >    s/between different/among all/

I rewrote that part in a different way.

 >    # Otherwise, columns will will automatically be balanced.
 > 
 >    s/will will/will/

Fixed.

 > 10. Conformance
 > ---------------
 > 
 >    # For the ‘column-rule-color’ property, conforming user agents are
 >    # only required to support the subset of color values defined in
 >    # [CSS21].
 > 
 >    This is already mentioned in the column-rule-color description. I
 >    suggest removing it from here.

Done.

 >    I also suggest copying the second paragraph from
 >      http://www.w3.org/TR/css3-namespace/#conformance
 >    into this section.

Done.

-h&kon
              Håkon Wium Lie                          CTO °þe®ª
howcome@opera.com                  http://people.opera.com/howcome
Received on Sunday, 22 February 2009 21:56:26 GMT

This archive was generated by hypermail 2.3.1 : Tuesday, 26 March 2013 17:20:16 GMT