On 06/27/2014 03:26 PM, David Fox wrote:Are you asking for a wiki-like thing for documentation? There were a few
> I would counter propose a place on hackage for people to type in or modify
> the documentation for functions, designed in such a way that the
> documentation would easily find its way back into the project's source code
> (with developer approval.) This way the documentation can be generated by
> people who only recently came to understand the function, so the questions
> a newcomer has are fresh in their mind.
>
times where this has been proposed such as
https://github.com/haskell/haddock/issues/72 but in general it turns out
that there's not enough interest for anyone to sit down and implement it
and make sure it all works properly. Patches should be going straight to
upstream rather than lingering on Hackage until someone notices them
(even with automated tools, it's a pain). I doubt many people would use
it for anything but typos because if you have enough knowledge about a
function to document it, you're likely to already be involved with the
project in some way and have means to report it properly.