https://lexi-lambda.github.io/blog/2016/06/12/four-months-with-haskell/#documentation-is-nearly-worthless - found this on reddit, criticizes haskell docs and praises racket docs:
they are so effective because of how the prose explains what each function does, when to use it, why you’d use it, and why you wouldn’t use it.
