96 lines
1.6 KiB
Markdown
96 lines
1.6 KiB
Markdown
# 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.
|