there is an issue integrating Liberator with compojure-api to get swagger-docs out, feedback welcome: https://github.com/metosin/compojure-api/issues/185