Problems with Swagger
blog.novatec-gmbh.de
Problems with Swagger
1–10 of 163 posts
Re: Problems with Swagger
#2My problem with Swagger is almost the opposite... it solves the problem (APIs are very complicated to use!) by embracing this complexity with more complexity and more tools. Rather, I believe the solution is a push to just have simpler APIs.
It's crazy to me that it's harder to write a Swagger file than it is to write the API itself. And there's a lot of tooling that benefits from Swagger, but... I've found they all work 80%. Codegen, documentation, etc get 80% of the way there.
(Also, OAS 3 has linking, which is very similar to your hypermedia complaint)
Re: Problems with Swagger
#3I'm surprised RAML isn't suggested as na alternative. http://raml.org/
Re: Problems with Swagger
#4> The Problems with Swagger
> This is a Swagger misusage problem, not a problem from Swagger per sé.
The TL;DR is a list of gotchas and best practices the author has learned from using Swagger.
Re: Problems with Swagger
#5Here is a cached version as the site is currently giving me an HTTP 500: http://webcache.googleusercontent.com/search?q=cache:uQABqVC...
Re: Problems with Swagger
#6My problem with Swagger is the Swagger editor. It just works sometimes, but sometimes everything is just red for no reason. Tried with Safari, ChrOme, Ff on different Macs. Am I the only one who thinks this tool is unusable?
Edit: Cheers to you guys at Novatec, have to take a look on InspectIT again.
Re: Problems with Swagger
#7> The Problems with Swagger > This is a Swagger misusage problem, not a problem from Swagger per sé. The TL;DR is a list of gotchas and best practices the author has learned from using Swagger.
Almost.
Re: Problems with Swagger
#8I'm surprised RAML isn't suggested as na alternative. http://raml.org/
Does it address the issues in the post?
Re: Problems with Swagger
#9This is a bit off topic, but I feel that Swagger etc... and actually most API docs are to human centric. You can't auto chain APIs together without a lot of developer intervention.
The one thing I saw that allowed that was SADI services [1]. An awesomely pragmatic use of the semantic web.
Pity it did not get picked up by Google etc...
Re: Problems with Swagger
#10I really like the idea of HATEOAS but I have never seen hypermedia controls done in the wild across any companies I've worked for nor on any client projects. I think it's very cool but a lot of development patterns don't consider it.