Re:An API is only as good as its documentation
by biscotti on Monday March 30, 2015 @11:13AM
(#9290037)
We're using swagger to great effect, the ability to add markdown against the endpoints allows us to describe them with both relevant documentation and examples.
http://oi60.tinypic.com/33llco5.jpg