Do API docs actually provide much benefit in practice? Does anyone actually use Javadocs, for example? The problem with documentation at this level is that it's too low level. It useful, maybe, as a quick reference once you already know the project.
How does this compare to JSON API? <a href="http://jsonapi.org/" rel="nofollow">http://jsonapi.org/</a><p>Is this a competing standard? I'm getting fairly nervous about the rise of competing "standards" with APIs.