Live data from Hacker News

Ask HN: Best books in API design

news.ycombinator.com

11–18 of 18 posts

Re: Ask HN: Best books in API design

#12
post #4

Not a book, but Trolltech (makers of Qt) has nice recommendations for API design: http://doc.trolltech.com/qq/qq13-apis.html

That's an excellent resource - I particularly like how they use examples from early versions of their own APIs of what not to do.

Re: Ask HN: Best books in API design

#14

There's a good video available "How To Design A Good API and Why it Matters" by Josh Bloch. There's a selection of slides to accompany a version of the talk here http://lcsd05.cs.tamu.edu/slides/keynote.pdf [PDF].

Where is the video available?

It's the first result on google:

http://www.youtube.com/watch?v=aAb7hSCtvGw

Re: Ask HN: Best books in API design

#15
Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries (2nd Edition) http://www.amazon.com/Framework-Design-Guidelines-Convention... is an interesting read and contains the result of actual work on building a large and successful framework. Has information on exceptions, naming, extensibility, and common patterns.

Re: Ask HN: Best books in API design

#16
post #4

Not a book, but Trolltech (makers of Qt) has nice recommendations for API design: http://doc.trolltech.com/qq/qq13-apis.html

A few years after that article came out Jasmine (from Trolltech) and several other devs put together a fantastic free pdf/book that I highly recommended. "The Little Manual of API Design": http://chaos.troll.no/~shausman/api-design/api-design.pdf

Re: Ask HN: Best books in API design

#17

While it's ostensibly about C, David Hanson's _C Interfaces and Implementations_ ( http://sites.google.com/site/cinterfacesimplementations/ ) has a lot of good discussion about API design for libraries, how to handle errors gracefully, etc. Many points apply just as well to libraries in OO or functional languages, REST APIs, etc., because questions about who should be responsible for error checking, managing resource…

dummy comment - sorry guys, i'm trying this out
Post reply on HN