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
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. :-]