Good docs with good practical examples of how to call the API. Many docs I've seen talk about the philosophy or background and then just dump the API functions

Good docs with good practical examples of how to call the API. Many docs I've seen talk about the philosophy or background and then just dump the API functions without any real explanation. In a nutshell: Give real world examples.