[Haskell-cafe] Comments from OCaml Hacker Brian Hurt

[Don Stewart]

david.waern:
> 2009/1/18 Don Stewart <dons at galois.com>:
> > ross:
> >> On Sat, Jan 17, 2009 at 09:12:32PM -0500, ajb at spamcop.net wrote:
> >> > And FWIW, I agree with everyone who has commented that the documentation
> >> > is inadequate.  It'd be nice if there was some way to contribute better
> >> > documentation without needing checkin access to the libraries.
> >>
> >> There is.  The current state of the docs may be viewed at
> >>
> >>       http://www.haskell.org/ghc/dist/current/docs/libraries/
> >>
> >> Anyone can check out the darcs repos for the libraries, and post
> >> suggested improvements to the documentation to libraries at haskell.org
> >> (though you have to subscribe).  It doesn't even have to be a patch.
> >>
> >> Sure, it could be smoother, but there's hardly a flood of contributions.
> >
> > I imagine if we set up a wiki-like system where the entire hackage docs
> > could be edited, as well as viewed, we would end up with a flood.
> >
> > A modification to haddock perhaps, that sends edits to generated docs to libraries@ ?
> 
> This has come up many times lately. I've created a ticket for it:
> 
>   http://trac.haskell.org/haddock/ticket/72
> 
> If anyone has suggestions for design or implementation of a system
> like this, don't hesitate to post to this ticket!
> 

Added to the entry on the proposals tracker,

    http://www.reddit.com/r/haskell_proposals/

If nothing else, this would make a good SoC project.

-- Don