Proposal: require Haddock comment for every new top-level function and type in GHC source code
johan.tibell at gmail.com
Mon Jun 30 20:16:52 UTC 2014
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.
More information about the ghc-devs