News for hackers. Stuff that matters.
Re:Rethinking web API development by btaitelb on Wednesday June 13, 2012 @03:30PM (#4107947)
Is "Documentation" just an implementation detail for what you really need: "Communication"? If I can have a smooth learning curve and a well-understood contract, then I'll have an API that developers enjoy using and integrating into products. Now granted, I don't see how this can be done currently without proper documentation (even if that just means naming the routes well, and providing illustrative examples), but that doesn't mean it's not possible.

There are no comments on this comment yet.