Add Return information to docstring. about servant-py

[erewok]

Use Data.Typeable for this?

Prelude> import Data.Typeable
Prelude Data.Typeable> show $ typeOf 5
"Integer"
Prelude Data.Typeable> show $ typeOf (5 :: Int)
"Int"

One thing that may be useful is to define a version of the Options type that includes more information about request bodies and also about objects returned, which we could put into the docstrings to help users.

The thing is, the objects going into and getting returned from APIs would need to derive Data and Typeable for this to work, so it could be fiddly and confusing why a particular options parameter makes things suddenly start breaking.

Inspiration for using Typeable and Data can be seen here:

• http://stackoverflow.com/questions/8457876/get-a-haskell-records-field-names-as-a-list-of-strings
• http://chrisdone.com/posts/data-typeable