Modèle de stabilité
plugin-kit-ai utilise des termes contractuels formels afin que les équipes puissent décider exactement ce qu'elles souhaitent normaliser.
Langage public versus langage formel
Les documents publics utilisent un vocabulaire de premier passage plus simple :
Recommendedpointe généralement vers les cheminspublic-stablede courant le plus fortAdvancedpointe vers des surfaces supportées plus étroites ou plus spécialiséesExperimentalcorrespond àpublic-experimental
Lorsque vous définissez une politique de compatibilité, les termes formels l'emportent.
Comment lire recommandé
Recommended est le langage du produit et ne remplace pas le contrat formel.
- cela signifie généralement un chemin de production promu
public-stable - cela ne signifie pas la parité entre toutes les cibles
- il ne met pas à niveau les surfaces
public-betaoupublic-experimentalpar le seul libellé
Public-Stable
Considérez public-stable comme le niveau sur lequel vous pouvez construire avec des attentes de production normales.
Il s’agit du niveau que la plupart des équipes devraient préférer pour les normes par défaut et le déploiement à long terme.
Bêta publique
Traitez public-beta comme pris en charge, mais pas gelé.
Utilisez la version bêta uniquement lorsque le compromis est explicite et en vaut la peine pour le produit.
Public-Expérimental
Traitez public-experimental comme une désabonnement opt-in en dehors des attentes normales de compatibilité.
Cela peut être utile pour l’apprentissage ou l’adoption précoce, mais cela ne devrait pas devenir la valeur par défaut de l’équipe.
Règle pratique
- Préférez le chemin recommandé pour le produit que vous créez.
- Utilisez les termes formels exacts uniquement lorsque vous avez besoin de précisions en matière de politique ou de compatibilité.
- Utilisez
validate --strictcomme porte de préparation pour le dépôt que vous prévoyez d'expédier.