We are making a REST API at our company, and we need to provide documentation. Are there any standards for documenting REST APIs? Can anybody recommend some API docs to emulate or to avoid? What do people think of the docs for some existing web services, like Yelp, Amazon, LinkedIn, etc?
Thanks for any input. Regards, Eric MacAdie
