A while back I mentioned a library we were working on at Wordnik to automatically document APIs. My (now former*) colleagues released it yesterday: http://swagger.wordnik.com/
It's pretty awesome, and was used to produce Wordnik's docs
. You can follow swagger on Twitter
for updates, or just bug the author, Zeke, who's cc'd here.
* I've joined a monastery