Ditch the Docs: Architecting APIs for Human Readability
An API that needs a separate document to explain every request is carrying too much hidden meaning. The usual response is to write better documentation. Sometimes that is necess...