News for hackers. Stuff that matters.
Re:Ask HN: What makes an API good? by ccvannorman on Tuesday October 28, 2014 @12:29PM (#8521807)
2) Documentation: Code examples, easy things like: "This is what you send, this is what you get." "If you change this, now you get this." Simple example heavy documentation. 1 example is worth a hundred lines of documentation.

This is the only point that I care about (and 5) for being relevant). SO MANY TIMES I have tried to use an API only to find books of documentation without any working examples. Speak to me in the language your API understands, working examples, and everyone will have a good time. :-]

Re:Ask HN: What makes an API good? by valarauca1 on Tuesday October 28, 2014 @12:39PM (#8521859)
Its a major sin a lot of developer commit. I'll just write 400+ pages of documentation.

That's great. Nobody will ever read it. Make it enjoyable to read and interact with. I keep this XKCD over my desk for a reason http://imgs.xkcd.com/comics/manuals.png