Re: Proposal for updating links on webplatform.org

Can we put a short section and a link to the Stewards page from here?

That way, Stewards does not have to be in the global nav as well as at the
bottom of every page.

Julee

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







-----Original Message-----
From: Chris Mills <cmills@w3.org>
Date: Tuesday, December 11, 2012 9:08 AM
To: Janet Swisher <jswisher@mozilla.com>
Cc: "public-webplatform@w3.org" <public-webplatform@w3.org>
Subject: Re: Proposal for updating links on webplatform.org
Resent-From: <public-webplatform@w3.org>
Resent-Date: Tuesday, December 11, 2012 9:08 AM

>Thanks Janet!
>
>So, final text is at http://docs.webplatform.org/wiki/WPD:About
>
>Can we link that from the main page of webplatform.org? Or do we need to
>put it somewhere more special?
>
>On 11 Dec 2012, at 16:54, Janet Swisher <jswisher@mozilla.com> wrote:
>
>> Looks good. Just one nit:
>> 
>> Change "About a year ago" to "In late 2011".
>> 
>> On 12/11/12 9:03 AM, Chris Mills wrote:
>>> I've had a go at drafting some text for the proposed "About" page. Is
>>>the kind of thing we want?
>>> 
>>> What is Webplatform.org?
>>> 
>>> Webplatform.org is a community-driven documentation site mainly
>>>focused on client-side web technologies. It was founded by several
>>>stewards, including Opera, Mozilla, Google, the W3C, Microsoft, Adobe,
>>>HP, Nokia and Facebook, with the aim of creating a definitive resource
>>>for web developers and designers to find all the information they need
>>>to do their job. The main part of the site is a wiki containing
>>>tutorials, concept articles and reference docs, but we also have a Q&A
>>>section, blog, and IRC chat, and we are aiming to expand out
>>>capabilities in the future to include live code examples, resources for
>>>educators, and more.
>>> 
>>> How the site was created
>>> 
>>> About a year ago, a small group ­ including people of W3C, Opera,
>>>Microsoft, Mozilla, Google and others ­ started talking about a new
>>>documentation project for information covering open web standards. Yes,
>>>there are lots of documentation sites already available, but some of
>>>them are low quality, out-of-date, or both. Some have great information
>>>about some subjects, but not others. And generally it takes web
>>>developers a lot of time to find all the information they want. It
>>>would be great for all the information providers to get together and
>>>produce one authoritative resource to tell web designers and developers
>>>all the information they need to know to do their job.
>>> 
>>> The idea was very warmly received by all parties involved, and so we
>>>all started solving problems together, working out an infrastructure
>>>for the project that would scale well and handle lots of different
>>>contributors, working out marketing and business plans, and putting
>>>together a large list of content from different resources ­ such as
>>>HTML5 rocks, MSDN, MDN and Operašs web standards curriculum ­ that
>>>would act as seed content to get the project started.
>>> 
>>> Webplatform.org philosophy
>>> 
>>> Ideally, we want this to be an ever-evolving project controlled and
>>>written by the community, rather than a bunch of big name vendors
>>>telling everyone what to do. The stewards are just there to provide
>>>structure and funding. We want everyone involved in the web community
>>>to feel they have to right to contribute new material and improve
>>>existing articles. It's your web, documented your way.
>>> 
>>> 
>>> On 11 Dec 2012, at 09:49, Chris Mills
>>> <cmills@opera.com>
>>>  wrote:
>>> 
>>> 
>>>> 
>>>> On 7 Dec 2012, at 12:28, Jonathan Garbee
>>>> <jonathan@garbee.me>
>>>>  wrote:
>>>> 
>>>> 
>>>>> Well, there should be an "about" page [1] since that issue has been
>>>>>sitting for quite a while.  That should be the "philosophy" if there
>>>>>is to be a page for it.
>>>>> 
>>>> So, adding an "About/philosophy" page to the site, and changing one
>>>>of the links in the main navigation to "About" - yup, I think this is
>>>>definitely a good idea.
>>>> 
>>>> I am happy to draft this. What do we need on there?
>>>> 
>>>> 1. More detail about what webplatform is
>>>> 2. Why the site was created
>>>> 3. Philosophy behind it
>>>> 
>>>> Anything else?
>>>> 
>>>> 
>>>>> The more link also needs to go [2] since it is a UX nightmare. There
>>>>>is no reason to have multiple links go to the same area in the same
>>>>>nav menu with different names. Should it ever have a different name
>>>>>in any navigation item?
>>>>> 
>>>> Sorry - I read the bug, but I don't know what other page you are
>>>>suggesting adding here - it is as if a part of the explanation on the
>>>>bug is missing? Can you elaborate on this second point?
>>>> 
>>>> 
>>>>> I also don't think we need a link to the stewards in the main
>>>>>navigation. There is a block of text lower down in the page going to
>>>>>the stewards page and then the footer logos on every page.
>>>>> 
>>>> Yeah, I agree really - I was just throwing it out there as another
>>>>idea. But your reaction confirms it in my mind as a bad idea.
>>>> 
>>>> 
>>>>> [1] https://www.w3.org/Bugs/Public/show_bug.cgi?id=19410
>>>>> 
>>>>> [2] 
>>>>> https://www.w3.org/Bugs/Public/show_bug.cgi?id=19557
>>> 
>> 
>> 
>> -- 
>> Janet Swisher
>> Mozilla Developer Network
>> Technical Writer/Community Steward
>
>

Received on Tuesday, 11 December 2012 20:49:07 UTC