Fascinating discussion of effective comment style in GHC (see both the thread and the wiki link) https://twitter.com/BrandonBloom/status/896139982271688704