Versions & releases
Politique de versioning Orbit et cycle de vie de la documentation.
État actuel
Orbit est en Pré-version.
Le sélecteur de version Documentation.AI utilise donc actuellement une seule valeur :
Pré-version
Cette valeur ne constitue pas une release publique.
Première release
Lorsque le produit et la documentation atteignent la première parité de production, la dimension courante est renommée :
Pré-version → v1.0
La première entrée du changelog est créée à ce moment-là.
Après v1.0
| Type | Exemple | Usage |
|---|---|---|
| Patch | v1.0.1 | correctif compatible |
| Mineure | v1.1 | capacité compatible ajoutée |
| Majeure | v2.0 | contrat ou comportement significativement incompatible |
Documentation multi-version
Une nouvelle branche de documentation n’est créée que lorsqu’au moins deux versions doivent réellement être consultables en parallèle.
À partir de ce moment, les pages spécifiques à une version utilisent des chemins distincts, par exemple :
v1/...
v2/...
Les contenus qui n’ont pas divergé ne doivent pas être dupliqués prématurément.
Recherche
La recherche Documentation.AI utilise strict-dimensions: true pour que l’assistant reste dans la version sélectionnée lorsqu’il existe plusieurs versions.
Source de vérité
Le numéro de version public décrit le produit livré, pas la maturité des documents internes ou le nombre de commits.