add open api

radar/2019-11-01/open-api.md

@@ -0,0 +1,21 @@
+---
+title:      "Open API"
+ring:       adopt
+quadrant:   tools
+
+---
+
+RAML and Swagger have been merged to OpenAPI. 
+The OpenAPI Specification is becoming a broadly adopted industry standard for describing modern APIs.
+
+OpenAPI v2 version is basically the former Swagger - and Swagger provides useful tools for OpenAPI like the online editor and viewer http://editor.swagger.io/
+We have also found that this version currently have a good tool support accross languages, so you will find API client and server generation tools for a lot of languages, which makes it quite easy to connect to an API that is described in OpenAPI standard.
+
+
+**OpenAPI v3**
+
+OpenAPI v3 adds more features to the specification - for example the ability to describe APIs supporting request/callback pattern.
+
+There is a very good api designer https://www.apicur.io/ and a good mock generator http://microcks.github.io/index.html
+
+The general tool support is excellent. See https://openapi.tools/

radar/2019-11-01/raml.md

@@ -6,3 +6,5 @@ quadrant:   languages-and-frameworks
 ---
 
 Since the RAML ecosystem lacks further development and additional tools, we decided to not stick with it anymore.
+
+Consider using ["OpenAPI"](/tools/open-api.html) instead.