Show descriptions of the models in the UI

[ayush]

swagger-ui ignores the model descriptors coming in from the server. Not good. It should show em

[pietervogelaar]

Any estimate when this will be implemented?

[tot-ra]

I've done it locally but as a hack by modifying generated javascript from coffescript and without using templates. It was around 1day work and I might have time to rewrite it properly, but looking at pending pull requests, they are not merged very often.

[pietervogelaar]

Do you have a link to the code with your modifications?

[tot-ra]

Yes, its under https://github.com/tot-ra/swagger-ui/tree/master/dist_old

[pietervogelaar]

Thanks... it's a start :) I hope the swagger team will pick it up soon... I think it should have high priority because you have to know what the API expects when using Swagger to test it.

[fehguy]

@pietervogelaar bumping up the priority on this...

[angelolloqui]

I would also like to see this one implemented

[ayush]

A push on this is coming through real soon.

[angelolloqui]

Awesome ayush! Thanks! faster was impossible!

[pietervogelaar]

Thanks a lot!! I will check it out asap!

[ayush]

@angelolloqui @pietervogelaar thanks. let me know if you guys have feedback on this.

[angelolloqui]

Well, I already tried it out and it looks great! The only "however" that I would say are the colors used for the even rows. I think it would be more useful if the datatype would be the "even" element instead of the full property, and therefore we could change its color (fields names in black, types in orange). Anyway, with or without this little improvement, it works like a charm! Thanks!

[ayush]

Thats a good point. However, the intent behind alternating colors for full properties (rather than field/type) was to make it make easy for the eyeball to jump from one property to another.

[angelolloqui]

@ayush I understand the point but I dont fully agree that is indeed easier to jump from one to another. In my opinion it would be easier with the field/type though. Anyway, as I said, it is more than enough for my purposes. Thanks!

[pietervogelaar]

I checked it out and it looks great! One point of feedback. All properties are comma seperated now and that saves a lot of vertical space. But maybe a toggle button would be nice to see the properties below eachother because it will read easier.