Best Practice: A catalog of web services/APIs along with corresponding usage documentation should be provided for every server/service

Documentation, preferably in some form available via the web, should be provided for each service/server that is maintained.  Information such as how to access the services/APIs and their responses along with some typical example code will provide a great benefit for those who wish to use them.