Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update documentation for Swagger-CodeGen Tool in the official web page at https://swagger.io/ #368

Open
LazaroOnline opened this issue Oct 8, 2024 · 1 comment

Comments

@LazaroOnline
Copy link

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 tool and 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.md

Now 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.

@frankkilcommins
Copy link
Collaborator

Thanks for the clarifications @LazaroOnline. We'll take a look at this and ensure the latest info is imported into the new docs site.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants