Conventions pour le champ de stabilité des emballages Cabal
https://stackoverflow.com/questions/3841218
italiano
english
français
española
中国
日本の
العربية
Deutsch
한국어
Português
RussianQuestion
Cabal permet une freeform Stabilité champ :
Stabilité: freeform
Le niveau de stabilité de l'emballage, par exemple,
alpha,experimental,provisional,stable.
Quelles sont les conventions de la communauté au sujet de ces valeurs de stabilité? Ce qui est considéré experimental et ce qui est provisional? Je ne vois que quelques paquets sont déclarés comme stable. Quel genre de stabilité fait-il référence, la stabilité de l'API exposée ou l'état ultime sans bug du logiciel?
La solution
Le champ est le plus souvent disparu maintenant, et ne doit pas être utilisé. Comme dit Max, il sera probablement remplacé par quelque chose de significatif à l'avenir.
Si vous êtes intéressé par l'histoire, le champ origine dans une proposition de conception pour la première série de Haskell bibliothèques hiérarchique . Ce document décrit la signification prévue à l'origine pour les valeurs.
Autres conseils
Actuellement, ce domaine est un guide très faible à la stabilité de la bibliothèque, donc est le plus souvent ignorée. Duncan Coutts (l'un des principaux développeurs et Cabal Hackage) a dit qu'il a finalement l'intention de remplacer tout ce domaine, avec quelque chose comme un système de vote social sur Hackage.
Personnellement (et je ne suis pas seul) Je laisse simplement toujours le champ de stabilité. Étant donné que ça va aller, son probablement pas la peine de perdre le sommeil sur ce qu'il faut mettre.
La signification originale destinée étaient:
- expérimentale : l'API est unstable . Il peut changer à tout moment, i.e. .: tout changement de numéro de version;
- provisoire : l'API est mouvement vers la stabilité . Il peut être modifié à chaque révision mineure, mais devrait fournir des versions de fonctions obsolètes;
- stable : l'API est stable . ajouts devraient être prises uniquement à versions mineures. Une fois les modifications de l'API, les fonctionnalités dépréciées doivent être conservés pendant au moins une version majeure.
Comme les autres réponses ont souligné, la communauté semble pas pour être suivant ces directives plus.
Simon Marlow Points sur, cela est décrit dans une proposition de conception pour la première série de bibliothèques hiérarchiques Haskell . Le lien d'origine est mort, mais vous pouvez trouver une copie dans le répertoire machine à remonter le temps .
