How do I produce the Swagger metadata for parameters and responses in yada?

@jonathanj: What kind of metadata for parameters were you thinking about? Because just having the parameters defined in the resource should be enough to add them to swagger. For responses you can add :swagger/responses key to method for now.

@griff: hmm, how do I document the meaning of the parameters?

Sorry, I'm on my phone now but I was looking through the manual code earlier and didn't see information for that.

Yeah, looking at it again the parameters are a schema mapping param name to type, it's not clear how you write a docstring for the param.

@jonathanj: yada uses ring.swagger and you use that to add description https://github.com/metosin/ring-swagger#adding-description-to-schemas

Ah, ring-swagger, that seems like the part of this that I was missing.

Presumably one can use this same method to document the response schema.

Is it possible to log exceptions somewhere when they occur?

I'm getting HTTP 500 (in IE 6) when trying to view the swagger UI resource and I'd like to know why.

(Or a better approach would be welcome too)