News for hackers. Stuff that matters.
Re:Annoyances of API Design by ascagnel_ on Thursday January 28, 2016 @12:54PM (#10989853)
> Document it well, and it will largely be usable.

And a simple, easy-to-use API will also be comparatively simple to document. If you're at the point where writing documentation is hard, that's strong code smell that something is amiss.

Re:Annoyances of API Design by laveur on Thursday January 28, 2016 @02:15PM (#10990466)
Agreed! The API should basically document itself. If you have to provide long examples of how to do something then there is a good chance the API isn't that good. Easy to use for developers makes a platform more stable and produces better quality apps, IMHO.