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

Re: Examples and GitHub (was: Guide to implementing CSS property pages)

From: Chris Mills <cmills@w3.org>
Date: Tue, 29 Jan 2013 11:11:08 +0000
Cc: PhistucK <phistuck@gmail.com>, public-webplatform@w3.org
Message-Id: <791270EF-0CE7-4605-AC1D-C184B3A666DA@w3.org>
To: Doug Schepers <schepers@w3.org>


On 28 Jan 2013, at 21:52, Doug Schepers <schepers@w3.org> wrote:

> Hi, Chris-
> 
> On 1/28/13 4:14 PM, Chris Mills wrote:
>> 
>> On 28 Jan 2013, at 18:18, Doug Schepers wrote:
>> 
>>> On 1/28/13 11:47 AM, Chris Mills wrote:
>>>> 
>>>> We could certainly do that, yes, good plan. Another possibility
>>>> perhaps would be to put the example on github, like this:
>>>> 
>>>> https://github.com/chrisdavidmills/background-image
>>>> 
>>>> Then we can publish the example directly, using that magical
>>>> gh-pages branch
>>>> 
>>>> http://chrisdavidmills.github.com/background-image/background-image.html
>>>> 
>>>> and accept pull requests from other contributors
>>> 
>>> This seems like a maintenance nightmare. Don't we already have too
>>> many ways to handle feedback? Is it likely that the code samples
>>> will have to change so frequently?
>> 
>> You might be right. I wonder if we can put things on github that you
>> can't do pull requests to, and then put a note to ask people to
>> provide feedback via WPD instead? I guess this will be irrelevant
>> anyway once we get the dabblet stuff set up.
> 
> I'd prefer we not go down the GitHub route right now at all.
> 
> Nothing we do right now will give us working inline examples, because we aren't yet putting iframes in the pages.
> 
> We are preparing the infrastructure to display live code examples in our own dabblet instance very soon, so we want to have code examples in pre blocks on the page itself.
> 
> It seems like extra hassle to have people put examples in pre blocks and in GitHub, and I would prefer we not introduce people to a workflow that we would abandon within a month or so anyway.

No worries - I have removed the Github reference ;-)
Received on Tuesday, 29 January 2013 11:11:18 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 8 May 2013 19:57:38 UTC