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
>> >
>> >
>> >
>> >
>> >
>> >
>> >
>> >
>> >
>>
>>
>>
>
>