Idea to allow people to comment on Haskell docs

[Duncan Coutts]

On Fri, 2006-01-20 at 09:30 +0000, Axel Simon wrote:
> On Thu, 2006-01-19 at 21:55 +0000, Duncan Coutts wrote:

> > So take another look at these example pages:
> > http://haskell.org/gtk2hs/docs/devel/
> > http://haskell.org/gtk2hs/docs/devel/Graphics-Rendering-Cairo-SVG.html
> > 
> > For the per-entry links, to conserve space I've just said [Comments]
> > rather than [User Comments] and used a smaller font. These cosmetic
> > things are easy to change if anyone complains.
> > 
> > So, opinions?
> 
> I guess the question is if people will actually start commenting on
> functions. So I would vote for the addition to haddock and see what is
> happening. Maybe we need then need to gather statistics about what links
> are clicked most and check which ones of these are empty (and left the
> user frustrated).

Or we could change the text to "Contribute notes" rather than "User
Comments" so that people are not disappointed when there are no existing
notes! :-)

(I think I'm joking, though I'm not entirely sure.)

Duncan