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.