Aller au contenu
Documentation : Versions et étiquettes

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émentQuandExemple
patchDes correctifs; rien de nouveau, rien de supprimé.1.4.0 → 1.4.1
minorQuelque 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
majorUn 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.

Étiquettes

Une étiquette est un nom qui pointe vers une version, pour que les installations puissent la demander au lieu d'un numéro. Les modérateurs et root les déplacent dans l'onglet Versions de l'élément.

  • latest est ce qu'obtient une installation sans version. Elle ne pointe que vers une version stable, et ne peut pas être supprimée.
  • next est l'endroit où vont les préversions par défaut.
  • Les autres étiquettes, comme stable-1 : de 1 à 32 lettres minuscules, chiffres et traits d'union, qui commencent par une lettre, et qui ne se lisent pas comme une plage de versions.

Quand un élément est installé par étiquette, l'étiquette est convertie en la version vers laquelle elle pointe à ce moment, et le fichier de verrouillage garde cette version jusqu'à ce que rmk update vérifie de nouveau.

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

ActionCe qui se passeQuand l'utiliser
deprecatedElle 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. »
yankedLes 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.