3 ms·
... and for the majority of things, that's absolutely fine. Function name + type signature + short description is very frequently plenty. decodeUtf8 :: ByteSt
by dllthomas 13y ago
... and for the majority of things, that's absolutely fine. Function name + type signature + short description is very frequently plenty.
decodeUtf8 :: ByteString -> Text
There are also quite a few things that are thoroughly documented, sometimes not in the Haddock (which, there's some argument, should be kept simple like a reference). Yesod has a book, and I hear Snap's getting one.
There are certainly cases that both don't have thorough documentation and need it, but they're not as many as you imply.