Proposal: require Haddock comment for every new top-level function and type in GHC source code

[Johan Tibell]

Richard,

Not requiring contributors to check that the Haddock render well is
OK. As long as the comments are there someone with free time on their
hands can always tidy up the rendering.

I'm looking forward to the day I can browse the GHC Haddocks and make
sense of them. I tried in the past but the generated docs aren't
accessible enough without any actual comments.