News for hackers. Stuff that matters.
Re:Ask HN: What makes an API good? by paulkoer on Tuesday October 28, 2014 @11:59AM (#8521627)
I highly recommend the following talk by Joshua Bloch: "How to design a good API and why it mattes" [1].

Key points:

- When in doubt, leave it out - you can never remove things from an API but always add to it.

- Write several clients of the API to get a good feel how its used. Three is usually enough, one is not.

[1] https://www.youtube.com/watch?v=aAb7hSCtvGw

There are no comments on this comment yet.