[Haskell-cafe] Doc generation?

Mikhail Glushenkov mikhail.glushenkov at gmail.com
Wed Jan 20 07:35:02 UTC 2016


On 20 January 2016 at 08:09, Sven Panne <svenpanne at gmail.com> wrote:
> Are there any safeguards on the Hackage server side to guarantee consistency
> between the uploaded package and the uploaded docs? (i.e. make sure it's the
> right version etc.) Are there checks on the server side that the
> cross-package links are correct? Does the server make sure that the docs
> contain source links?

If I'm reading [1] correctly, no such checks are performed.

> If the answer to any of these questions is "no", I consider even the
> possibility of uploading docs by hand a bug. Wrong/partial documentation is
> worse than no documentation at all...

You're welcome to open a ticket on the hackage-server bug tracker.

[1] https://github.com/haskell/hackage-server/blob/master/Distribution/Server/Features/Documentation.hs#L223

More information about the cabal-devel mailing list