Date: Sun, 5 Jan 2014 20:47:27 -0500
From: Clark Gaebel <cgaebel@uwaterloo.ca>
To: Mateusz Kowalczyk <fuuzetsu@fuuzetsu.co.uk>
Cc: haskell-cafe <haskell-cafe@haskell.org>
Subject: Re: [Haskell-cafe] Please fix documentation for you Hackage
        packages!
Message-ID:
        <CA+aES6NVWY_EJKzpWSTap1b3BTEWVzh2=+qTchiCMeLgtjeFbw@mail.gmail.com>
Content-Type: text/plain; charset="utf-8"

Is there any way you could tag that list with the author so that we can
Ctrl+f ourselves?


On Sun, Jan 5, 2014 at 8:37 PM, Mateusz Kowalczyk
<fuuzetsu@fuuzetsu.co.uk>wrote:

> Greetings caf?,
>
> As some of you might have noticed recently, there seems to be quite a
> few packages with broken documentation on Hackage recently. If you are
> an owner of such package, please consider fixing it. There's a thread on
> cabal-devel about this if you're interested in details.
>
> Here's a list of packages uploaded since beginning of 2013 for which the
> documentation was broken as of yesterday:
> http://fuuzetsu.co.uk/misc/sorted.txt
>
> If your package is on that list, your documentation is broken. Only the
> most recent versions of packages were being considered.
>
> I outline how to fix your documentation (in most cases this means
> uploading it by hand) in a blog post I just published. Please refer to:
>
> http://fuuzetsu.co.uk/blog/posts/2014-01-06-Fix-your-Hackage-documentation.html
>
> The post contains a link to as script which naively attempts to automate
> the burden of uploading the docs manually. If your package can't be
> built simply with ?cabal configure && cabal build && cabal haddock
> --hyperlink-source?, you'll have to adapt it to your situation.
>
> Thanks. I hope to see fewer packages with broken documentation in the
> future.
> --
> Mateusz K.
> _______________________________________________
> Haskell-Cafe mailing list
> Haskell-Cafe@haskell.org
> http://www.haskell.org/mailman/listinfo/haskell-cafe
>



--
Clark.

Key ID     : 0x78099922
Fingerprint: B292 493C 51AE F3AB D016  DD04 E5E3 C36F 5534 F907
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.haskell.org/pipermail/haskell-cafe/attachments/20140105/61df048c/attachment-0001.html>