I prefer hand-written. But other people like Swagger https://developers.helloreverb.com/swagger/ https://developers.helloreverb.com/swagger/, I/O Docs https://g

I prefer hand-written. But other people like Swagger https://developers.helloreverb.com/swagger/ https://developers.helloreverb.com/swagger/, I/O Docs https://github.com/mashery/iodocs https://github.com/mashery/iodocs, Daux (although this is just a style framework) http://daux.io/ http://daux.io/ and http://apiary.io/ http://apiary.io/