Hi all - I'm using swagger from compojure-api, and am struggling with a few questions I seem not to find answers for in the docs:
1. I'm using specs like (def URL s/Str)
, and then (defschema Article {:url URL})
, and would like for them to show up in the generated API docs, e.g. the models. But there, I only get Article {url (string)}
. Is there a way to achieve something like Article {url (URL)} URL(string)
?
2. Is there a way to add a description at the top of a (context)
, so that it would show up before any route documentation? I would like to add information how to use the various routes in the context.
3. I have specs like (defschema Article {:name s/Str :description s/Str})
and then use a slightly modified version of it in a route, e.g. :body-params [article :- (-> Article (dissoc :description))]
or :return (-> Article (dissoc :description))
. The API honors this, checking param or return value correctly. But the swagger docs always show the full Article schema!?
Thanks.