Idea to allow people to comment on Haskell docs
duncan.coutts at worc.ox.ac.uk
Fri Jan 20 04:56:20 EST 2006
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
(I think I'm joking, though I'm not entirely sure.)
More information about the Libraries