[Haskell-beginners] hiding documentation for non-exposed modules

Dave Bayer bayer at cpw.math.columbia.edu
Wed Mar 31 07:32:39 EDT 2010


On Mar 30, 2010, at 2:55 PM, Ashish Agarwal wrote:

> However, the haddock generated documentation includes even the non-exposed modules, which is not what I want since end-users should not see these.

And why do you feel that way?

Some of us are old enough to remember the "glass walls, men in white coats" era of computing. Shouldn't Haskell be a language where everyone gets to see everything?

Put this differently, coming from any language with an order of magnitude more users and a careful vetting process for libraries, it can sure seem at first like Hackage is a hippy co-op where any anyone can put food up on the shelves. (Actually, that is the case!)

Going out of your way to make it easy to see your beautiful code can help set people at ease, assuring them that they don't have to rely just on "standard packages" and their own code.


More information about the Beginners mailing list