2 ms·
There are some good beginner tutorials, but beyond that the documentation is absolutely terrible. The typical documentation for a Haskell library will be a page
by TheCoelacanth 13y ago
There are some good beginner tutorials, but beyond that the documentation is absolutely terrible. The typical documentation for a Haskell library will be a page that lists all of the modules in the library with a link to a page for each module. The page for each module will be a list of functions in the module with a type signature, and if you are lucky a one sentence description of what the function does. There will not be a single explanation or example of how to actually use the library.
- 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.