i use ring-swagger but the way to build swagger docs was so limited I ended up doing the swagger json myself and serving that json from my own route, honestly it is way the heck easier that way