Consider using makeFields, not makeLenses

[fizruk]

HasParamSchema will still be useful.

makeFields should shorten many names in Data.Swagger.Lens.
For example it would turn this code:

swagDoc :: Swagger
swagDoc = toSwagger (Proxy :: Proxy API)
  & info.infoTitle .~ "Todo API"
  & info.infoVersion .~ "1.0"
  & info.infoDescription ?~ "This is an API that tests servant-swagger support for a Todo"
  & info.infoLicense ?~ License "MIT" (Just (URL "http://mit.com"))

into

swagDoc :: Swagger
swagDoc = toSwagger (Proxy :: Proxy API)
  & info.title .~ "Todo API"
  & info.version .~ "1.0"
  & info.description ?~ "This is an API that tests servant-swagger support for a Todo"
  & info.license ?~ License "MIT" (Just (URL "http://mit.com"))

@dmjio what do you think? Would this simplify customizing spec by a significant ammount?

[dmjio]

yea, this would be really cool, as long as we don't have any overlapping lenses. In that case it might be best to make a typeclass that contains a lens. (example: if title is found in more than one data type). And make instances for the respective types.

[fizruk]

@dmjio makeFields will do exactly that! Check out its documentation :)

[dmjio]

oh that's beautiful, for some reason I was thinking of makeLenses. Looks perfect