[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