haddock

haddock copied to clipboard

See as an example this index page on hackage. Having:

attrib :: LString -> (String, LString)

would be better than current layout (plain attrib, no sig, just module link).

see also: people disagreeing with me.

@ffaf1 The package documentation you show as an example happens to be generated with an older version of the Haddock theme. Let's consider a more recently-updated package instead: https://hackage.haskell.org/package/servant-openapi3-2.0.1.5/docs/doc-index.html

In this example, we can see that the space if fairly constrained, so the type signatures cannot easily be displayed by default.

If we want to go through with this, we'd have to display the type signatures with a tooltip.