3 ms·
I always found Swagger to not be very readable or usable. APIs keep changing, and are meant to be malleable, not rigid. IMO, Swagger always ends up being too mu
by czardoz 9y ago
I always found Swagger to not be very readable or usable. APIs keep changing, and are meant to be malleable, not rigid. IMO, Swagger always ends up being too much planning, too little implementation.
I remember having a bunch of discussions about these issues when I worked on the Postman Collection Format (https://github.com/postmanlabs/postman-collection/blob/develop/examples/collection-v2.json https://github.com/postmanlabs/postman-collection/blob/devel...) which can be very flexible.