I wrote about a few of the different formats before: http://pedro.by4am.com/past/2014/5/23/get_more_out_of_your_service_with_machinereadable_api_specs/ http://p

I wrote about a few of the different formats before: http://pedro.by4am.com/past/2014/5/23/get_more_out_of_your_service_with_machinereadable_api_specs/ 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 https://github.com/pedro/sinatra-schema