Exemples / DO-DON'T — Chapitre 36 — SemVer et politique de releases

Document compagnon non normatif tant qu'une règle n'est pas explicitement référencée comme normative par le chapitre.

Exemples actuellement présents dans le chapitre

Exemple 1

MAJOR.MINOR.PATCH

Exemple 2

MAJOR -> rupture de compatibilité publique
MINOR -> ajout rétrocompatible
PATCH -> correction rétrocompatible

Exemple 3

pre -> alpha -> beta -> rc -> stable

Exemple 4

pre    développement/intégration active ; fonctionnalités incomplètes possibles
alpha  ensemble cohérent et testable ; API encore susceptible d'évoluer
beta   fonctionnalités prévues essentiellement complètes ; stabilisation
rc     candidat à la release ; changements limités aux corrections nécessaires
stable aucun identifiant de prerelease

Exemple 5

X.Y.Z-0.pre.N
X.Y.Z-1.alpha.N
X.Y.Z-2.beta.N
X.Y.Z-3.rc.N
X.Y.Z

Exemple 6

1.4.0-0.pre.3
1.4.0-1.alpha.1
1.4.0-2.beta.2
1.4.0-3.rc.1
1.4.0

Exemple 7

X.Y.Z-0.pre.N.fix.M
X.Y.Z-1.alpha.N.fix.M
X.Y.Z-2.beta.N.fix.M
X.Y.Z-3.rc.N.fix.M

Exemple 8

1.4.0-3.rc.2
1.4.0-3.rc.2.fix.1
1.4.0-3.rc.3

Exemple 9

1.4.0

Exemple 10

1.4.1

Exemple 11

X.Y.Z+build.N
X.Y.Z+doc.N

DO / DON'T / WHY / compiler error / edge cases

La couverture structurée de cette section sera enrichie au fur et à mesure de la fermeture des règles du chapitre. La migration 0.2.12 conserve volontairement les exemples historiques dans le chapitre afin de ne perdre aucun contexte normatif.

1.6 KiB Raw Blame History