[Haskell-cafe] Please fix documentation for you Hackage packages!

[Niklas Hambüchen]

Yes, it does make a lot of sense in these cases.

It is not tedious. This Python script automates it for you:

  https://gist.github.com/nh2/8284831

(The original block post also contains a minimal script.)

Maybe we can add a command `cabal upload-docs` that does this?

On Mon 06 Jan 2014 16:47:57 CET, Erik Hesselink wrote:
> In some cases it actually makes sense. For example, my kqueue package
> is in the list above. It is a binding to a MacOS/BSD C library, and
> the hackage build bot runs on linux. So I should actually upload the
> documentation...
>
> Erik
>
> On Mon, Jan 6, 2014 at 4:35 PM, Sven Panne <svenpanne at gmail.com> wrote:
>> To be honest, I actively encourage people to *not* fix their package
>> documentation manually. This is tedious, error-prone, and I bet there
>> will be tons of packages then where the actual code and documentation
>> will disagree (worse than no documentation at all), we're humans after
>> all. Fixing Hackage is the way to go, not some guaranteed-to-fail
>> crowd-sourcing... :-/
>> _______________________________________________
>> Haskell-Cafe mailing list
>> Haskell-Cafe at haskell.org
>> http://www.haskell.org/mailman/listinfo/haskell-cafe