I wrote about a few of the different formats before: http://pedro.by4am.com/past...

		pedrobelo on Jan 19, 2015 \| parent \| context \| favorite \| on: Ask HN: What's the best way to write an API spec? I wrote about a few of the different formats before: http://pedro.by4am.com/past/2014/5/23/get_more_out_of_your_s... And been working on a tool to merge the schema with actual code for Sinatra apps: https://github.com/pedro/sinatra-schema