[Haskell-cafe] is it normal for docs to be pending for 24 hours?
code at funwithsoftware.org
Wed Nov 9 21:11:14 UTC 2016
On 11/9/16 5:06 AM, Tom Ellis wrote:
> If you get your package into Stackage then the docs will be built there too,
> and it's probably more reliable. I uploaded a new version of Opaleye
> yesterday and the docs haven't been built by Hackage yet but they have been
> built by Stackage.
I get your point, but I don't really like seeing the suggestion that
Hackage should be abandoned because Stackage is better. (I especially
dislike packages like "resourcet" which have entirely forgone giving a
description of the package in the cabal file, and instead have only a
note saying you should go to Stackage instead.) Hackage and Stackage
serve different purposes. Hackage is all packages, while Stackage is a
curated set of packages. (Therefore, Hackage is essentially the
"upstream" of Stackage.) We shouldn't give up on Hackage.
If FP Complete has a better doc builder, then it would be nice to see FP
Complete and haskell.org work together on getting Hackage to use the FP
Complete doc builder. Although a bit of competition can be healthy, it
would also be nice to see cooperation in places where there is not a
difference in philosophy. (And hopefully, "should have docs" is
something everyone can agree on.)
More information about the Haskell-Cafe