frankkilcommins
commented
1 month ago Thanks for the clarifications @LazaroOnline. We'll take a look at this and ensure the latest info is imported into the new docs site.
Open LazaroOnline opened 1 month ago
frankkilcommins
commented
1 month ago Thanks for the clarifications @LazaroOnline. We'll take a look at this and ensure the latest info is imported into the new docs site.
The documentation for the swagger tools is way outdated:
It can be updated or replaced with the info from the respective repository's Readme since it is up-to-date in GitHub (but not in your own official webpage):
swagger-api/swagger-editor swagger-api/swagger-ui swagger-api/swagger-codegen
The problem is that I was trying to use the
swagger-codegen tooland went to the official documentation here and followed those steps only to realize that is using a waaay older version of the tool (v2.3.0 with Java 7) that doesn't even support the new specs, so after loosing some time trying to make that work, I latter realized those docs are outdated and the real latest version was somewhere else here: https://github.com/swagger-api/swagger-codegen/blob/master/README.mdNow I can't trust anything from https://swagger.io since it has been un-maintained for 7 years now (v2.3.0 was released in 2017). Also this was reported in the issue #353 and I even created a pull request to fix it here, but it has been closed as "not-needed" (???), I believe it was a mistake, so please, can you re-check that so the page is effectively updated? I would appreciate it. Thanks.