Siempre he trabajado con Swagger, así que mi opinión aquí es muy subjetiva y para nada imparcial. Pero te lo resumiré con palabras de otro:
Swagger es el VHS de los lenguajes de especificación de APIs
Es decir, no te voy a defender que sea el mejor, ni el más limpio, ni el que tiene la mejor sintaxis, ni el más bonito, pero si el que más soporte tiene de todo tipo de herramientas y utilidades.
Como muestra de esto que te digo, me quedo con la actualización final que se da al final de este artículo, después de explicar todas las nuevas bondades de RAML
Update: Unfortunately, the tooling hasn’t been able to keep up with the changes to RAML specification quickly enough and I didn’t have a choice but to switch over to using Swagger 2.0 in YAML format. I would have preferred to use RAML 1.0 for its concise syntax and superior support for reusability and modularisation but the lack of decent and freely available tooling made it impossible to produce API specifications that could be easily shared and explored, both internally and externally. Time will tell if I will be able to move back to using RAML 1.0.
Comentar