Contributions
Re: How to generate documentation using Swagger api or server for C++ application
He is looking for a solution that scans C++ code and generate swagger document. SWAGGER EDITOR IS NOT AN IDEAL SOLUTION FOR SUCH SITUATIONS. Swagger-scannerkind of solution would be ideal in such scenario. Also, I would like to highlight that many open source swagger projects do not have good documents. Is it possible to do something about it ?2KViews0likes0CommentsRe: Need for swagger scanner
Swagger inspector is not an open source tool. Also swagger-core only works with Maven/Gradle. It would have been great if there was a dedicated Java class that can scan for annotations and generate swagger document without depending on Maven/Gradle. Also, swagger-codegen is an open-source and it supports many programming languages. In the same way, swagger-scanner would be a wrapper would generate swagger docs and it would support multiple programming languages. Also, it would not depend on a specific build tool. Many of the open-sourced swagger projects do not have good document. A document should clearly lay out input, output and procedure to get output.1.9KViews0likes0CommentsNeed for swagger scanner
Swagger code-gen (doc -> code) is a huge project which generates client/server stub for different programming langauges and frameworks. In the same way, there should be a project "swagger scanner"; which would work for different programming languages and framework. It will scan code and generate swagger document in YAML/json file. Requriments for swagger-scanner Wrapper for all open-source tools to generate swagger doc. It would look inside code and generate swagger doc for different programming language. User would be able to run swagger-scanner.jar (just like swagger-codegen). Users would not have to depend on build tools to generate swagger doc. Honestly, I would happy if there is some tool which satisfies second requriement.1.9KViews0likes2CommentsRe: Getting Started with Swagger
To simply put, Integrating swagger with any tool is a nightmare. Docuemnts are great example of how not to write a document. I believe that most of the people would end up writing YAML file manually. For example, read this document "How to use swagger without maven ? ". This is a partial document. I have downloaded dependencies then what should I do with them??8.6KViews0likes2CommentsAre there any plans to update
Are there any plans to updatehttps://swagger.io/docs/open-source-tools/swagger-codegen/? Document was written for codegen v2.3.0 Latest stable release is v2.4.0 Latest release is v3.0 People use swagger to write good docs. On the other hand, swagger itself do not have good docs. How ironic ! Swagger-editor is awesome. Anyone can understand it. On left side, you have input and on right side there is output. But swagger-codegen is like mysterybox. Document does not explain what should one expect. Codegen definately stands for code-generation but what kind of code I should expect? How would the code would look like? How would the document created by code-gen would look like? How would client look like? I will update my response; once I will be able to open this mysterybox.1.2KViews0likes0Comments