Swagger-metadata options

option1.clj

; option1: Liberator-like
(GET "/pizzas" []
  :return   [Pizza]
  :summary  "Gets all Pizzas"
  :notes    "'nuff said."
  :nickname "getPizzas"
  (response (get-pizzas)))
  

option2.clj

; option2: as map
(GET "/pizzas" []
  {:return   [Pizza]
   :summary  "Gets all Pizzas"
   :notes    "'nuff said."
   :nickname "getPizzas"}
  (response (get-pizzas)))
 
;; allows also:
 
(def pizzas-doc*
  {:return   [Pizza]
   :summary  "Gets all Pizzas"
   :notes    "'nuff said."
   :nickname "getPizzas"}
 
(GET "/pizzas" [] pizzas-doc*
  (response (get-pizzas)))

option3.clj

; option3: meta-data
(^{:return   [Pizza]
   :summary  "Gets all Pizzas"
   :notes    "'nuff said."
   :nickname "getPizzas"} 
 GET "/pizzas" []
  (response (get-pizzas)))