W3C home > Mailing lists > Public > public-webplatform@w3.org > January 2013

Re: sample CSS property page: font-size

From: Mike Sierra <letmespellitoutforyou@gmail.com>
Date: Mon, 21 Jan 2013 15:48:32 -0500
Message-ID: <CAECD243BpcP9ZttpE_6T=nsVHzXKhWE-m4FWpJMsO+Q2rLTqdw@mail.gmail.com>
To: PhistucK <phistuck@gmail.com>
Cc: public-webplatform@w3.org
Can you give me a more detailed overview of what you mean by a
"detailed overview"?  ;-)  What kind of info do you think belongs on
each prop page rather than in a tutorial? Not that that's necessarily
a better idea; just trying to form an idea of where the line between
expository & reference should fall.

I did avoid some of the more detailed info in the spec on suggested
scaling guidelines for keywords, and how they map to headings, but I
figured that's more appropriate for implementors.

Good point on tables for the compatibility notes & relevant specs; will fix.

Re the tables merging desktop/mobile browsers, I figure the two
classes of browser are much closer together these days, with a great
deal more shared code, especially true for CSS prop's.

FYI, that weird animation delay only occurs in webkit, which I filed
as bug #107315. I left it in the demo because I figured any weirdness
is worth knowing about.

--Mike Sierra

On Mon, Jan 21, 2013 at 2:44 PM, PhistucK <phistuck@gmail.com> wrote:
> Even though it is pretty self explanatory, there is no detailed overview of
> the property, there are only notes and examples.
> I believe there should be an overview.
> The summary is concise, maybe too concise (I do not have ideas)? hehe.
> The compatibility notes are not formatted the way they are currently
> supposed to be (a table), which I think is more helpful (the current way,
> not you way) for distinguishing the note for every version/edition.
> The standards information is also not formatted in a table. Not sure which
> is better, though.
> Mixing mobile browsers and desktop browsers at the same line/section is also
> not a good idea, in my opinion.
> The example feels a little weird for me, due the first section
> growing/shrinking after a delay.
> But, overall, great work!
> ☆PhistucK
> On Mon, Jan 21, 2013 at 8:21 PM, Mike Sierra
> <letmespellitoutforyou@gmail.com> wrote:
>> In last Thursday's meeting I had an action item to mock together an
>> ideal CSS property page for authors to refer to, along with the
>> guidance to feel free to reorganize & throw out anything that didn't
>> work well. I found it quite difficult to wrestle with the site's
>> template system to get what I wanted, so I mirrored it & hacked on the
>> page here:
>> http://letmespellitoutforyou.com/x/webplatform/font_size.html
>> As you can see, I also mucked with the design a bit to compress the
>> page wherever possible, and added an <iframe> to a simple tool showing
>> what the CSS actually does. I think all CSS property pages should have
>> a similar demo feature, especially once you head towards the
>> difficult-to-understand ones like font-size-adjust. (I hope dabblet
>> will allow direct embedding & can be modified with option lists for
>> CSS keyword property values.)
>> Any suggestions — content or formatting — please let me know. Thanks,
>> --Mike Sierra
Received on Monday, 21 January 2013 20:48:59 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:20:46 UTC