[Haskell-cafe] is it normal for docs to be pending for 24 hours?

[Patrick Pelletier]

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.)

--Patrick