Swagger Editor is really a notepad editor.

1,170 views
Skip to first unread message

raj s

unread,
Apr 13, 2016, 1:33:16 PM4/13/16
to Swagger
Hi All,

I was going through the swagger editor. I see it just gives the option to write the spec in YAML and JSON. I appear to be ugly ( only my view ) and tedious. Editor should be simple GUI which takes couple of input in create rest of things automatically.

I would imagine it should provide tree like structure starting root as service name and we should be able to add nodes as resources and further nodes to show what operation these resources have. 

Now my question is there such option in editor which i am not able to see right now ? Do you have some future plan to have that kind of ui support ? if I am willing to put effort to add that option in editor UI, will that be acceptable to community ?

Regards,
Rajender Saini

Lucien Combe

unread,
Apr 15, 2016, 11:02:40 AM4/15/16
to Swagger
Hello Rajender,

You are right, but i was able to get a working tool set using a local Swager-Editor, a local Swagger-UI and an 3rd part editor like sublimeText.
In sublime text you can edit your documentation and quickly see changes in Swagger-UI.

I use local swagger-editor only for validating purpose and to convert YAML to JSON, and reverse. 

To have a more efficient editor,  the best approach to me, could be to have a sublimeText extension or an Eclipse plugin. This way you can basically  grab all 
advantages of those tools.

Regards,

raj s

unread,
Apr 17, 2016, 7:05:50 PM4/17/16
to Swagger
Hi Lucien,

Thanks for looking into this and provide your valuable input/feedback. Specifically I was looking more specialized UI editor without me looking into the swagger spec details of file. Actually I find one starting point with the swagger code repo it self. 


That is kind of editor I am looking for. I will go back and see how I can enhance and contribute to that project. 

Lucien Combe

unread,
Apr 18, 2016, 5:13:35 AM4/18/16
to Swagger
You are welcome,

Just another trick i am using, is the SublimeText Editor snippets, thus i have my own with a Swagger specs template and example for create new documentation quickly.
For those who are interested on, it's here :


For instance you can add comment in the template to get the specification attributes description on the go.

Frans Thamura

unread,
Jul 11, 2016, 11:15:36 PM7/11/16
to Swagger
hi all
is there an electron app of swagger editor?

F
Reply all
Reply to author
Forward
0 new messages