[Haskell-cafe] Package documentation complaints -- and a suggestion

Gregory Collins greg at gregorycollins.net
Tue Oct 25 09:54:01 CEST 2011

On Tue, Oct 25, 2011 at 4:34 AM, wren ng thornton <wren at freegeek.org> wrote:
> I'm not so sure about that exemption. The "experimental" stability level
> seems to be the norm on Hackage and often means "I use this for real
> projects, but because I use it for real projects I'm not quite willing to
> hammer the API in stone just yet".
> ...
> Before dealing with automatic documentation requirements, perhaps it'd be
> better to develop a standard consensus on the terms used in the stability
> field and actively advocating for people to adopt it, as was done with the
> PVP.

I think there's no need to cajole people into it -- if Hackage 2 puts
"stable" packages on a different / better list, there's your social
pressure. Right now the stability flag in the .cabal file, as you
pointed out, is almost completely content-free.

Gregory Collins <greg at gregorycollins.net>

More information about the Haskell-Cafe mailing list