Recommendation for documenting JSON API?

Question

Are there any accepted standards or best practices for documenting a set of JSON API's? Done a fair bit of searching around and there seems to be a bit of a mish-mash of style / formats.

Maybe making too big a deal over this ... at some level docs is docs, but figured I'd ask.

Answer 1

I don't think there is standard way, but who is setting the standard if not the big fishes? Look at how Twitter is documenting it perhaps (http://apiwiki.twitter.com/)? Thats probably what most developers would expect i guess.