[Haskell-cafe] Proposal: remove "Stability" from haddock documentation on hackage
James Cook
mokus at deepbondi.net
Wed Jun 8 17:50:34 CEST 2011
On Jun 8, 2011, at 11:08 AM, Tom Murphy wrote:
> On 6/7/11, James Cook <mokus at deepbondi.net> wrote:
> [...]
>>
>> The name of the field could be better, though. On first exposure,
>> people tend to think "stability: experimental" or "stability:
>> unstable" means the package is likely to crash (For those who don't
>> know, it means the API is likely to change in future releases).
>>
>
> What is the way to indicate actual code stability? Some packages on
> Hackage definitely have "broken parts."
>
Since all cabal fields are set before uploading that would imply
someone is uploading something they know to be broken, which doesn't
seem right. But assuming some legitimate reason exists, WARNING or
DEPRECATED pragmas on the bad stuff would probably be a good way to go.
-- James
More information about the Haskell-Cafe
mailing list