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

Re: APIs Page

From: Chris Mills <cmills@opera.com>
Date: Thu, 24 Jan 2013 11:53:41 +0000
Cc: Doug Schepers <schepers@w3.org>, "public-webplatform@w3.org" <public-webplatform@w3.org>
Message-Id: <7BF7B964-A419-4165-B4A6-077CB4828FAB@opera.com>
To: Scott Rowe <scottrowe@google.com>
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.

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 23 Jan 2013, at 21:06, Scott Rowe <scottrowe@google.com> wrote:

> Yes, the apis page is still pre-beta :) .  I was thinking of using these "API topics" to briefly describe the more in-demand APIs and provide links to both reference and tutorial articles. Once we have a well-rounded story for an API, where we have full reference docs and solid tutorials, such an API could be presented in this section.
> 
> We've got some good content coming for the IndexedDB and WebRTC APIs, including tutorials. We've already got full reference plus tutorials for Web Audio - thanks to Dave Gash. 
> 
> So, I'd love to hear from the community, which APIs should we feature here? If you'd like a list of candidates, check out the API Project page.
> 
> Thanks!
> +Scott
> 
> 
> 
> On Wed, Jan 23, 2013 at 12:26 PM, Doug Schepers <schepers@w3.org> wrote:
> Hi, folks-
> 
> Our new icon-based layout [1] is great, and we've made great progress on our plan for CSS and APIs!
> 
> Jeff Jaffe (W3C CEO) pointed out to me that we've still got some highly-visible placeholders ("Explore our HTML docs", "API topic #1", "API topic #2", "API topic #3") [2] that could benefit from pointing to concrete resources.
> 
> What are our top 3 (or 5, or 10 ...) API articles, in terms of relevance and completeness? Can we feature those on the APIs landing page right now?
> 
> 
> [1] http://docs.webplatform.org/wiki/Main_Page#Explore_our_web_development_docs
> [2] http://docs.webplatform.org/wiki/apis#Explore_our_HTML_docs
> 
> Regards-
> -Doug
> 
Received on Thursday, 24 January 2013 11:54:19 UTC

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