Check out The Ten Essentials for Good API Documentation by by. Here is an excerpt:
API documentation is the number one reference for anyone implementing your API, and it can profoundly influence the developer experience. Because it describes what services an application programming interface offers and how to use those services, your documentation will inevitably create an…
The full article is available here.
