Versions et étiquettes
Versions sémantiques, étiquettes, dépréciation et retrait.
La documentation fournie avec Ronne AI Marketplace 0.3.0, traduite de l'anglais.
Versions
Chaque publication est une version : major.minor.patch, comme 1.4.0. La première publication est 1.0.0. Une version ne change jamais une fois publiée : un correctif est une nouvelle version.
Une préversion s'adresse aux premiers testeurs, comme 1.1.0-beta.1 : un identifiant de lettres minuscules et de chiffres, qui commence par une lettre, et un numéro qui augmente à chaque préversion.
Personne ne tape de version : elle découle du choix fait à la publication, un élément à la fois ou plusieurs à la fois, où un seul choix donne à chaque élément sa propre version suivante.
Patch, minor ou major
La personne qui publie choisit le type de changement; la version en découle.
| Incrément | Quand | Exemple |
|---|---|---|
| patch | Des correctifs; rien de nouveau, rien de supprimé. | 1.4.0 → 1.4.1 |
| minor | Quelque chose de nouveau qui ne casse rien pour personne : un fichier, une dépendance, un mot-clé, une option. | 1.4.0 → 1.5.0 |
| major | Un changement qui casse quelque chose pour les installations : une option, une dépendance ou un fichier nommé supprimé. | 1.4.0 → 2.0.0 |
Pour une proposition de changement, la boîte de dialogue de publication en suggère un selon ce qui a changé, et explique pourquoi. Quand vous publiez plusieurs à la fois, Suggested for each utilise la suggestion de chaque proposition; sinon, choisissez un incrément pour tous. Une première publication est 1.0.0 dans tous les cas.
Publier en bloc
Les soumissions approuvées peuvent être publiées ensemble : cochez-les dans My submissions (les vôtres), ou dans l'onglet To release de la file de revue (modérateurs et root, celles de n'importe qui), puis cliquez sur Release selected. Select all couvre la page affichée, dans les deux cas : affichez 100 éléments par page, ou filtrez d'abord, pour en publier plus à la fois.
- Un seul ensemble de réglages pour tous : stable ou préversion, l'incrément (celui suggéré pour chaque changement, ou un seul pour tous), l'étiquette (celle par défaut de chaque version, ou une seule pour tous) et des notes de version facultatives. Une première publication est toujours 1.0.0.
- Chaque version est affichée d'abord, comme le ferait chaque boîte de dialogue de publication, et Release reste désactivé tant que les réglages ne conviennent pas à toutes.
- Les dépendances passent en premier. En sélectionner une ajoute ses dépendances approuvées qui ne sont pas encore publiées, marquées comme incluses; une dépendance encore en revue l'exclut.
- Chacune est publiée séparément. Celle qui échoue, comme une proposition périmée, n'arrête qu'elle-même et ce qui en dépend dans le lot (ignorées); les autres sont publiées. Au plus 50 à la fois.
Déprécier ou retirer
| Action | Ce qui se passe | Quand l'utiliser |
|---|---|---|
| deprecated | Elle reste installable, et rmk affiche son message chaque fois qu'il l'installe ou la met à jour. | Il existe une meilleure version ou un meilleur élément : « Utilisez 1.2.0 ou plus récent. » |
| yanked | Les nouvelles installations ne peuvent pas l'obtenir; un projet dont le fichier de verrouillage la fixe l'installe encore, avec un avertissement. Si latest pointait vers elle, l'étiquette revient à la plus récente version stable restante. | Elle est défectueuse ou dangereuse. Le retrait peut être annulé. |
Là où l'élément a une utilisation signalée, la page Versions affiche les exécutions et les installations de chaque version sur 30 jours, et les deux boîtes de dialogue les indiquent avant que vous confirmiez : qui recevrait encore un avertissement de dépréciation, et ce qu'un retrait bloquerait.