News for hackers. Stuff that matters.
Re:Ask HN: What makes a great API? by billswift on Saturday October 15, 2011 @08:43AM (#3114695)
From the highest level view:

1) Reliability - it can be counted on to do its job.

2) Consistency - it does it in the same, or at least the same small set of, ways each time.

3) Clarity and Discoverability - it is easy to see or find out what it does.

Re:Ask HN: What makes a great API? by neinsun on Saturday October 15, 2011 @08:57AM (#3114719)
Documentation?????
Re:Ask HN: What makes a great API? by billswift on Saturday October 15, 2011 @10:55AM (#3114905)
I would put adequate documentation as part of clarity and discoverability, both because they serve the same end and because the inherent clarity and discoverability can increase or decrease the amount of documentation needed to effectively use the API. So maybe I should have said "clarity, discoverability, and documentation".