I am wondering if the RAML spec (1.0) and modules and such are slowing down or if there is anything on the horizon to speak of? I am looking to use RAML, but thought by now the 1.0 would be out and that there would be a lot more development activity around the spec and tools. A fellow colleague came to me today and brought up using Swagger 2, and at first I thought RAML was far ahead, but looking at the Swagger site… they have a lot of stuff going on. They seem to have far more modules for more languages, although I’ll be honest and saying I haven’t looked into whether or not they are all updated Swagger 2 or not.
But I am not trying to make RAML look bad…I think it’s great. My concern is I may be tasked with building out our API doc, sdk, cli and other areas, and I’ve been betting on RAML, but with others looking at Swagger and it’s popularity, I am lacking a good argument for either side. Can any of you offer a few reasons why RAML would be the better way to go vs Swagger 2? We’ll mostly be looking to capitalize on a “single source of truth” document that we then use to generate server side JAX-RS (and possibly Spring and Scala…which RAML lacks both but Swagger 2 has work going on in those areas), as well as client side SDKs and CLIs that use the generate SDKs. As well, good documentation for our consuming developers to use to figure out our APIs.