Re: Values of CSS properties

Btw, I think `data_types` in the URL should be `values` instead. Not only it’s more concise and understandable, but also on par with the spec title: CSS Values and Units [1]. Even in this thread, the subject is “*Values* of CSS properties”...

[1]: http://www.w3.org/TR/css3-values/

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






On Jul 26, 2013, at 00:34, Mike Sierra <letmespellitoutforyou@gmail.com> wrote:

> 
> It's linked from that property page: css/data_types/length
> 
> Otherwise a concept page about multiple values is easy enough.
> 
> --Mike S
> On Jul 25, 2013 4:50 PM, "Julee Burdekin" <jburdeki@adobe.com> wrote:
> +1 But I don't think we have such a page... J
> 
> 
> ----------------------------
> julee@adobe.com
> @adobejulee
> 
> From: Mike Sierra <letmespellitoutforyou@gmail.com>
> Date: Thursday, July 25, 2013 1:47 PM
> To: Lea Verou <lea@w3.org>
> Cc: PhistucK <phistuck@gmail.com>, julee <jburdeki@adobe.com>, WebPlatform Public List <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> 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> 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> 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 ? @leaverou
>> 
>> 
>> 
>> 
>> 
>> 
>> On Jul 25, 2013, at 23:31, Julee Burdekin <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
>> > @adobejulee
>> >
>> >
>> >
>> >
>> >
>> > From:  Lea Verou <lea@w3.org>
>> > Date:  Thursday, July 25, 2013 1:25 PM
>> > To:  WebPlatform Public List <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 ? @leaverou
>> >
>> >
>> >
>> >
>> >
>> >
>> >
>> >
>> >
>> 
>> 
>> 
> 
>