v0.2.12

examples/036-semver-et-politique-de-releases-examples.md

@@ -0,0 +1,95 @@
+# 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
+
+```text
+MAJOR.MINOR.PATCH
+```
+
+### Exemple 2
+
+```text
+MAJOR -> rupture de compatibilité publique
+MINOR -> ajout rétrocompatible
+PATCH -> correction rétrocompatible
+```
+
+### Exemple 3
+
+```text
+pre -> alpha -> beta -> rc -> stable
+```
+
+### Exemple 4
+
+```text
+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
+
+```text
+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
+
+```text
+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
+
+```text
+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
+
+```text
+1.4.0-3.rc.2
+1.4.0-3.rc.2.fix.1
+1.4.0-3.rc.3
+```
+
+### Exemple 9
+
+```text
+1.4.0
+```
+
+### Exemple 10
+
+```text
+1.4.1
+```
+
+### Exemple 11
+
+```text
+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.