Re: Values of CSS properties

+1 But I don't think we have such a page... J


----------------------------
julee@adobe.com
@adobejulee

From: Mike Sierra <letmespellitoutforyou@gmail.com<mailto:letmespellitoutforyou@gmail.com>>
Date: Thursday, July 25, 2013 1:47 PM
To: Lea Verou <lea@w3.org<mailto:lea@w3.org>>
Cc: PhistucK <phistuck@gmail.com<mailto:phistuck@gmail.com>>, julee <jburdeki@adobe.com<mailto:jburdeki@adobe.com>>, WebPlatform Public List <public-webplatform@w3.org<mailto:public-webplatform@w3.org>>
Subject: Re: Values of CSS properties

I prefer <length> with a link to the length page and maybe a brief note about percentages and keywords, but separate lines for 2, 4, and 1-line syntax.   Perhaps "accepts multiple values" should be a flag in the overview table, with a link to discussion of comma-separated syntax?

--Mike S


On Thu, Jul 25, 2013 at 4:40 PM, Lea Verou <lea@w3.org<mailto:lea@w3.org>> wrote:
Isn’t that the purpose of the examples section?

Lea Verou
W3C developer relations
http://w3.org/people/all#lea ? http://lea.verou.me ? @leaverou






On Jul 25, 2013, at 23:39, PhistucK <phistuck@gmail.com<mailto:phistuck@gmail.com>> wrote:

While I understand what <length> means exactly, I am not sure everyone does. In order to be correct and accurate, as well as usable for newcomers, I think we should have <length> as well as one or two quick and short examples to make the newcomers figure out the usage easily and quickly.

So, say -
background-position: <length> <length>;
  background-position: 20px 30px;
  background-position: 15em 5%;

Or something similar.


☆PhistucK


On Thu, Jul 25, 2013 at 11:32 PM, Lea Verou <lea@w3.org<mailto:lea@w3.org>> wrote:
Yes, that’s what I’m talking about. Glad we agree. Anyone else want to chime in?

Lea Verou
W3C developer relations
http://w3.org/people/all#lea ? http://lea.verou.me<http://lea.verou.me/> ? @leaverou






On Jul 25, 2013<tel:2013>, at 23:31, Julee Burdekin <jburdeki@adobe.com<mailto:jburdeki@adobe.com>> wrote:

> Hi, Lea: Are you talking about where it lists the values:
>
> Values
>
> 20px 40px
>     Any standard CSS...
>
> Yes, I agree: <length> is better than some arbitrary example value.
>
> J
>
> ----------------------------
> julee@adobe.com<mailto:julee@adobe.com>
> @adobejulee
>
>
>
>
>
> From:  Lea Verou <lea@w3.org<mailto:lea@w3.org>>
> Date:  Thursday, July 25, 2013<tel:2013> 1:25 PM
> To:  WebPlatform Public List <public-webplatform@w3.org<mailto:public-webplatform@w3.org>>
> Subject:  Values of CSS properties
>
>
> I see this pattern in many CSS properties. For example,
> http://docs.webplatform.org/wiki/css/properties/background-positionSome

> have generic data types as values (e.g. length), others try to use
> specific examples.
> What’s the correct way?
> Personally, I think specific examples can be confusing, since the reader
> needs to extrapolate the general rule.
>
> Lea Verou
> W3C developer relations
> http://w3.org/people/all#lea ? http://lea.verou.me<http://lea.verou.me/> ? @leaverou
>
>
>
>
>
>
>
>
>