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

RE: APIs Page

From: Eliot Graff <Eliot.Graff@microsoft.com>
Date: Fri, 1 Feb 2013 16:50:14 +0000
To: Eliot Graff <Eliot.Graff@microsoft.com>, Chris Mills <cmills@w3.org>
CC: Doug Schepers <schepers@w3.org>, Scott Rowe <scottrowe@google.com>, "public-webplatform@w3.org" <public-webplatform@w3.org>
Message-ID: <CE3A5BFD1228D84A8D9C158EEC195FD53F63AD34@TK5EX14MBXW601.wingroup.windeploy.ntdev.microsoft.com>
I believe I was successful in adding changed content. 

The editing was somewhat challenging in trying to design the words to bridge the space between appealing to experienced developers (and not insult with trivial descriptions of what HTML is) and those coming to learn (and not lose them with lack of description or too much industry slang).

It's a draft, so feel free to change and advise.

Thanks.

Eliot

-----Original Message-----
From: Eliot Graff [mailto:Eliot.Graff@microsoft.com] 
Sent: Friday, February 1, 2013 8:36 AM
To: Chris Mills
Cc: Doug Schepers; Scott Rowe; public-webplatform@w3.org
Subject: RE: APIs Page

Maybe I've been demoted. Or maybe Doug and Ryan were smart enough to keep me from the inner sanctum. 

Either someone can add me, or I can send you the changes to review and add. I'm fine either way.

Thanks,

Eliot

-----Original Message-----
From: Chris Mills [mailto:cmills@w3.org]
Sent: Friday, February 1, 2013 8:32 AM
To: Eliot Graff
Cc: Doug Schepers; Scott Rowe; public-webplatform@w3.org
Subject: Re: APIs Page

It is restricted so it can only be edited by admins, but you should have those privilieges...weird.

Chris Mills
Opera Software, dev.opera.com
W3C Fellow, web education and webplatform.org Author of "Practical CSS3: Develop and Design" (http://goo.gl/AKf9M)

On 1 Feb 2013, at 16:27, Eliot Graff <Eliot.Graff@microsoft.com> wrote:

> Chris et al.
> 
> Is there something unusual about the main page? [1]  I'm trying to add edits to the descriptions of the main sections, but I can't. I'm logged in, but under "Edit," my only options are Upload file, History, View, and Refresh.
> 
> Thanks,
> 
> Eliot
> 
> [1] http://docs.webplatform.org/wiki/Main_Page
> 
> 
> -----Original Message-----
> From: Chris Mills [mailto:cmills@opera.com]
> Sent: Thursday, January 24, 2013 7:24 AM
> To: Doug Schepers; Scott Rowe
> Cc: public-webplatform@w3.org
> Subject: Re: APIs Page
> 
> I have worked through all the other dead links, and done the following, to act as a short term band aid:
> 
> Here's what I have done with the main landing page links for now (http://docs.webplatform.org/wiki/Main_Page, and subpages):
> 
> "Beginner's guide": the beginner's guide material is currently going nowhere, so for the moment I have replaced what was there with the old beginners guide. It is not as good, but it does lead somewhere useful at least. The new text has been stored temporarily in TEST:beginners. 
> 
> "General web concepts": I have created all the missing subpages for 
> these and populated them with the available articles for each category 
> (previously listed on http://docs.webplatform.org/wiki/OLD:concepts)
> 
> "HTML": no dead links, seems ok for now
> 
> "CSS": no dead links, seems ok for now
> 
> "Accessibility": no dead links, seems ok for now
> 
> "JavaScript": there were a few links going nowhere, and for now I have fixed these like so:
> 
> 	* "Regular expressions": pointed to http://docs.webplatform.org/wiki/concepts/programming/javascript/regex
> 	* "Events": pointed to http://docs.webplatform.org/wiki/events for now, although this should really be moved to javascript/events, and fleshed out. A lot.
> 	* "Language features": I've just pointed this to the "tutorials" page 
> for now, as I really think this shouild exist eventually, but for now, 
> the tutorials page covers some of this stuff
> 
> "Document Object Model": there were a few links going nowhere, and for now I have fixed these like so:	
> 
> 	* "DOM Learning material": I created a page for the tutorials, at http://docs.webplatform.org/wiki/dom/tutorials, just so it linked to somewhere
> 	* "Language features" and "Objects": I deleted these for now, but we can add them back in later on if they are needed.
> 	
> "APIs" : I have passed this to Scott ;-)
> 
> Chris Mills
> Opera Software, dev.opera.com
> W3C Fellow, web education and webplatform.org Author of "Practical
> CSS3: Develop and Design" (http://goo.gl/AKf9M)
> 
> On 24 Jan 2013, at 13:36, Doug Schepers <schepers@w3.org> wrote:
> 
>> Hi, Scott-
>> 
>> On 1/24/13 6:53 AM, Chris Mills wrote:
>>> I think at the moment it would be good to just link to *something* 
>>> rather than leave these links going nowhere. For the moment, can you 
>>> just get these empty API categories linking to the landing pages for 
>>> the APIs you have got finished or at least started? I see you've got 
>>> a decent number in this state already.
>>> 
>>> In the meantime, I'll look at the others that we've got hanging, and 
>>> work out some solutions for now.
>> 
>> I agree with Chris here... anything at all is better than the confusing current state. Several topics are already marked as complete (*), so let's start there.
>> 
>> My own priorities would be for stuff that is fairly mature and usable across browsers today, with a further focus on general utility. Disregarding the current status of the items, I would propose the following priorities:
>> 
>> xhr
>> canvas *
>> geolocation
>> indexeddb *
>> file *
>> websocket
>> web-storage
>> workers
>> web-messaging
>> appcache *
>> audio-video *
>> css-regions *
>> timing
>> webaudio *
>> webrtc *
>> 
>> Many of the ones that are already complete are aspirational at this point; I'm a big fan of Web Audio API, but currently it only works in WebKit, and it's still changing, for example.
>> 
>> Regards-
>> Doug
> 
> 
> 
Received on Friday, 1 February 2013 16:51:26 UTC

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