W3C home > Mailing lists > Public > www-tag@w3.org > April 2013

API design sanity-testing and public-script-coord...

From: Charles McCathie Nevile <chaals@yandex-team.ru>
Date: Fri, 26 Apr 2013 12:40:58 +0300
To: "W3C TAG" <www-tag@w3.org>
Message-ID: <op.wv5yakaqy3oazb@chaals.local>
Hi folks,

on the public-script-coord list there has been a discussion about better  
early review of APIs, and one of the upshots was a request that when a  
group starts a new API, they send a pointer to that list. Ideally this  
will enable review of the basic design patterns by more people who are  
good at developing "javascript-style APIs", which would be helpful.

Web Apps will do this, and I would strongly encourage other groups to do  
it too. Having consistent design across all the APIs we offer developers  
will help them to learn new ones easily and correctly, as well as make  
sure that people who are writing third-party documentation don't get  
caught out by unexpected differences.

There is also a draft of a "design API cookbook" somewhere (Robin is cc'ed  
to add a link ;) ) that could use some loving, to make it a useful  



Charles McCathie Nevile - Consultant (web standards) CTO Office, Yandex
       chaals@yandex-team.ru         Find more at http://yandex.com
Received on Friday, 26 April 2013 19:41:39 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 22:56:55 UTC