[johns]

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