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

Johan Tibell johan.tibell at
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 mailing list