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