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

On 27/04/2013 10:16 , Markus Lanthaler wrote:
> That's a pretty outdated version. You should look at
>
> http://darobin.github.io/api-design-cookbook/

That's still pretty outdated, and was never completed anywhere near the 
level at which I initially wanted to (a lot of it is crude notes that I 
was planning on changing/building upon in the future). And way too much 
of it is focused on helping people work with WebIDL, when it would be 
better if they spent more time thinking about the right API and then 
getting WebIDL to work for them.

In other words, I encourage anyone who wishes to work in this area to 
steal any and all content they wish to take from that document, but I 
wouldn't consider it to be anywhere near good, or at a level at which 
someone who doesn't already know APIs should pay too much attention to 
it (though the WebIDL sections can help navigate some pitfalls).

It doesn't even recommend Futures ;)

-- 
Robin Berjon - http://berjon.com/ - @robinberjon

Received on Friday, 3 May 2013 12:19:13 UTC