Re: Column examples

Thanks for all the helpful notes! I've actually gone through to do an audit
of the column examples and have updated them all to follow the formatting,
cleaning up some examples and moving towards prefix-free with the note for
each. I've also updated the respective section examples to match these as
well.

http://code.webplatform.org/gist/5305475 - column-width
http://code.webplatform.org/gist/5306158 - column-span
http://code.webplatform.org/gist/6288958 - column-rule-width,
column-rule-style, column-rule-color
http://code.webplatform.org/gist/5305647 - column-gap
http://code.webplatform.org/gist/6393571 - column-fill
http://code.webplatform.org/gist/6288917 - column-count

-Shali


On Mon, Aug 26, 2013 at 11:21 AM, Scott Rowe <scottrowe@google.com> wrote:

> Clearly I had a great weekend and forgot to come to work today. Thanks
> Carlos!
>
>
> On Mon, Aug 26, 2013 at 11:18 AM, Carlos Araya <carlos.araya@gmail.com>wrote:
>
>> I think this came only to me :-)
>>
>> Not a problem.  Work and training have kept me quiet in the WPD front.
>> I'm sorry about that.
>>
>> Carlos
>>
>>
>> On Mon, Aug 26, 2013 at 9:56 AM, Scott Rowe <scottrowe@google.com> wrote:
>>
>>> Thanks Carlos! As I mentioned earlier in the thread, prefixes are
>>> extremely unpopular. That said, however, they're going to be around for a
>>> while, and citing them in examples is not necessarily a problem, as long as
>>> we do it with the non-prefixed value last, as in the example from the
>>> editing guide (http://docs.webplatform.org/wiki/WPD:CSS_property_guide):
>>>
>>> background-image: -webkit-linear-gradient(top,#aaa,#eee);
>>> background-image: -moz-linear-gradient(top,#aaa,#eee);
>>> background-image: -ms-linear-gradient(top,#aaa,#eee);
>>> background-image: -o-linear-gradient(top,#aaa,#eee);
>>> background-image: linear-gradient(to bottom,#aaa,#eee);
>>>
>>> There are instances where prefixes are just not appropriate, such as
>>> when the property is long-established (most CSS level 1 properties), and
>>> using a prefix is just silly.
>>>
>>> But I'd like to hear what others think about this. Should we include
>>> prefixes in our examples?
>>>
>>>
>>>
>>> On Sun, Aug 25, 2013 at 4:47 PM, Carlos Araya <carlos.araya@gmail.com>wrote:
>>>
>>>> Just my two cents.
>>>>
>>>> If we're documenting the standard we shouldn't give examples that don't
>>>> use what the standard states.
>>>>
>>>> I understand the need to make people aware of what the vendors do with
>>>> prefixes but would much rather encourage people to work with libraries like
>>>> Prefixfree that will make coding to a standard much easier for everyone
>>>> involved.
>>>>
>>>> When I created the examples for columns during the San Francisco sprint
>>>> earlier this year I also raised the issue of using Prefixfree rather than
>>>> code multiple versions of the same code and then have to track when a
>>>> vendor has started supporting the unprefixed version and whether the
>>>> vendor-specific version was still supported.
>>>>
>>>> Carlos
>>>>
>>>>
>>>> On Tue, Aug 20, 2013 at 5:38 PM, Shali Nguyen <shalinguyen@gmail.com>wrote:
>>>>
>>>>> Hi there!
>>>>>
>>>>> I was going through the webplatform.org docs today and became
>>>>> immediately interested. I've been wanting to find a way to help contribute
>>>>> to the community and would love to lend a hand!
>>>>>
>>>>> I plan on hopping in on tomorrow morning's meeting but wanted to try
>>>>> and get started to see if I could be of help. Upon reviewing "columns"
>>>>> article from the Aug 14th week, it looks like you guys are missing some
>>>>> examples and have some that exist that aren't formatted cross browser
>>>>> w/vendor prefixes.
>>>>>
>>>>> Here are my suggested improvements on live examples for Multi-column
>>>>> sections:
>>>>>
>>>>> *http://docs.webplatform.org/wiki/css/properties/columns
>>>>> *Currently has no live example.
>>>>>
>>>>>    - Existing example: None
>>>>>    - New example: http://code.webplatform.org/gist/6288803
>>>>>
>>>>> *http://docs.webplatform.org/wiki/css/properties/column-count
>>>>> *Existing live example doesn't show column-count. I've created a
>>>>> simpler example for only the column-count property.
>>>>>
>>>>>    - Existing example: http://code.webplatform.org/gist/5305530
>>>>>    - New example: http://code.webplatform.org/gist/6288917
>>>>>
>>>>> *http://docs.webplatform.org/wiki/css/properties/column-rule
>>>>> *Currently has no live example.
>>>>>
>>>>>    - Existing example: None
>>>>>    - New example: http://code.webplatform.org/gist/6288958
>>>>>
>>>>> *http://docs.webplatform.org/wiki/css/properties/column-rule-color
>>>>> *Currently has no live example.
>>>>>
>>>>>    - Existing example: None
>>>>>    - Propose to use this existing example:
>>>>>    http://code.webplatform.org/gist/6288958 (same column-rule above)
>>>>>
>>>>> *http://docs.webplatform.org/wiki/css/properties/column-rule-width
>>>>> *Uses jsfiddle example instead of codelet.
>>>>>
>>>>>    - Existing example: http://jsfiddle.net/dstorey/K6X54/
>>>>>    - Propose to use this existing example:
>>>>>    http://code.webplatform.org/gist/6288958 (same column-rule above)
>>>>>
>>>>> *http://docs.webplatform.org/wiki/css/properties/column-rule-style
>>>>> *Uses an example only visible in firefox.
>>>>>
>>>>>    - Existing example: http://code.webplatform.org/gist/5305898
>>>>>    - Propose to use this existing example:
>>>>>    http://code.webplatform.org/gist/6288958 (same column-rule above)
>>>>>
>>>>> It looks like *column-fill *and *column-gap* examples are fine unless
>>>>> we want to make sure vendor prefixes are also included. If that's the case,
>>>>> here is the updated example (forked from existing example):
>>>>> http://code.webplatform.org/gist/6289096<http://code.webplatform..org/gist/6289096>
>>>>>
>>>>> --
>>>>> Shali Nguyen
>>>>> www.shalinguyen.com
>>>>> follow me @shalinguyen
>>>>> AIM: shalinguyen
>>>>>
>>>>
>>>>
>>>
>>
>


-- 
Shali Nguyen
www.shalinguyen.com
follow me @shalinguyen
AIM: shalinguyen

Received on Friday, 30 August 2013 21:07:22 UTC