...
- The canonical specification language for HTTP-oriented APIs in TIER is Swagger 2.0
- Why Swagger and not RAML or API Blueprint? (see this recent comparison on dzone)
- In the move from version 1 to version 2, Swagger incorporated a lot of RAML's best features (around reusable definitions, etc.)
- Swagger 2 has been adopted as the basis for further development by the industry-launched Open API Initiative (http://openapis.org, more on github here) and that should strengthen the already thriving Swagger developer and adopter community
...