Last week I had to rush to figure out how best to document some public developer API's for Happy Apps. We had already created some great RESTful OAUTH2 friendly API's for use with our iOS / Apple Watch app release but had not yet worked out how to present these API's to our users and any newcoming users that might want to use them. There are several possible avenues you can take when documenting your API's
Automated API Docs
Some options exist where the syntax of your comments...