Re: Proposal for updating links on webplatform.org

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 <mailto:jREMOVEswisher@mozilla.com>
Mozilla Developer Network <https://developer.mozilla.org>
Technical Writer/Community Steward

Received on Tuesday, 11 December 2012 16:54:53 UTC