I was browsing https://www.haskell.org/haddock/ and thought that the page could really need some love!
Compared with other parts of haskell.org its looks are very outdated; that not problematic per se, while impressions do matter, I’m very much a fan of MFW, but it does not only look outdated: it is outdated: the last release mentioned (and release notes linked) is 2.15.0 (Aug '14), while on Hackage the most recent one is 2.25.0 (March '21). Note, this is a site of haskell.org, the central and first access point for all things Haskell!
The linked https://haskell-haddock.readthedocs.io/ has the version 2.20.0 documented, which is also not the most current one (2.20.0 was uploaded to Hackage May '18), so the “latest” docs are three years out of date, formally (even if possibly nothing has changed, just maintenance to compile with newer GHCs that makes a very bad impression, as the reader cannot be sure about this).
The whole gives a subjective impression of haddock being in a state of decay (even if it is technically maintained).
Given how important good documentation is, and for any package to get good documentation on hackage it has to go through haddock, I think it would be imperative to give a little more love and care to Haddock, even if it is stable and mostly in maintenance mode.
After all, it’s the library/package authors that evolve our ecosystem and we should make their experience as smooth and easy as possible.
(I was vacillating between “Uncategorized” and “Haskell Foundaton” to post this topic into. Feel free to recategorize if it’s not right here).