Swagger is generating invalid docs

[bryce-anderson]

As noted in #46, the swagger validator has alerted us that the docs generated by the http4s demo are invalid.

[jcranky]

Is this still a thing?

[bryce-anderson]

Yes, it's still not perfect.

[bryce-anderson]

I looked into this a bit, and the example with bad docs is not entirely rho's fault: the return type of a route is a JValue, which has no special meaning to rho so it fails to build a proper model for it. The other example is twirl Html, which is the same issue.

I still think rho could be smarter about what it's adding as a ref etc to avoid situations like this.