metosin / reitit

A fast data-driven routing library for Clojure/Script
https://cljdoc.org/d/metosin/reitit/
Eclipse Public License 1.0
1.43k stars 256 forks source link

Swagger parameter descriptions? #396

Closed crclark closed 4 years ago

crclark commented 4 years ago

I am playing with the ring-spec-swagger example, and I noticed that the parameters don't have descriptions. Furthermore, I wasn't able to find anything about parameter descriptions in the docs. Is there a way to document each parameter?

Screen Shot 2020-05-08 at 1 27 08 PM

pablo-develop commented 4 years ago

https://github.com/metosin/spec-tools/blob/master/test/cljc/spec_tools/swagger/core_test.cljc#L14-L19

you need to use spec tools, there is an example on the link

ikitommi commented 4 years ago

doc improvements welcome