Idea to allow people to comment on Haskell docs

[Simon Peyton-Jones]

| I've had a go at patching Haddock to put a link on the page for each
| module. It's controlled by an optional --wiki=URL flag.
| 
| As an example, I used this with the (devel version of the) Gtk2Hs
docs:
| 
| http://haskell.org/gtk2hs/docs/devel/
| 
| For example this page:
| 
| http://haskell.org/gtk2hs/docs/devel/Graphics-Rendering-Cairo-SVG.html

It looks great!  But I'd never have found the link if you hadn't pointed
me at it.

Rather than "Wiki" say "User comments".  

And I think the per-entry [User comment] link is essential.  Typically
people are going to be looking at a particular thing.  For example, here
	
http://haskell.org/gtk2hs/docs/devel/Graphics-Rendering-Cairo-SVG.html#v
%3AsvgRenderFromString
is where I'd look for the link for svgRenderFromString.

Does MediaWiki support anchors in the middle of a page?  That's
essential here -- we want one Wiki page for one Haddock page.



On a closely related matter, Benjamin Pierce told me how often he wished
that there was a link from the Haddock documentation to the source code
for a function.  Especially for Prelude functions, he's dead right.  So
another really useful Haddock enhancement would be the ability to add
links to the source code from the Haddock docs --- again on a
per-function basis.  Do you feel like adding that too?   Where should
the code live?  I'd suggest snap-shoting it at the moment that the
Haddock docs are generated, and putting the files with the Haddock docs.

Simon