Politique de versionnement

Stabilité et versionnement

Un numéro de version élevé et des releases fréquentes ne signifient pas qu’origam casse souvent. Cette page explique ce que signifie le numéro, comment les releases sont publiées et où les changements sont consignés.

Ce que signifie le numéro 2.x

Le numéro 2.x est historique. En pratique, origam est un projet pré-1.0 qui porte une étiquette 2.x.

En dessous de la 3.0.0, les numéros mineur et correctif relèvent de la comptabilité, pas d’un contrat de compatibilité.

Pourquoi les releases sont fréquentes

Chaque changement fusionné dans le paquet publié obtient sa propre release corrective. Les changements ne sont pas retenus pour être groupés dans une release hebdomadaire ou mensuelle : le numéro de correctif grimpe donc vite.

Un correctif est une correction de bug. Une mineure est une fonctionnalité de taille moyenne, à impact limité sur l’usage existant. Les changements qui ne touchent pas le paquet publié, comme ce site, la documentation, les tests ou l’outillage, ne produisent aucune release.

Comment sortent les ruptures

Jusqu’à la 3.0.0, une rupture peut sortir dans une version mineure. Elle est alors documentée explicitement et honnêtement dans le CHANGELOG.

Le CHANGELOG est l’endroit à consulter avant de monter de version mineure.

Lire le changelog

Ce que sera la 3.0.0

La 3.0.0 est réservée à la séparation du paquet en modules. Ce sera la première rupture majeure annoncée.

Rien d’autre ne sort sous ce numéro : ni un lot de corrections de bugs, ni une mise à jour de dépendance. Cette page ne donne pas de date.

Voir la roadmap

Politique de dépréciation

Il n’y a pas de long cycle de dépréciation. Au stade actuel du projet, la rupture nette est préférée à une couche de compatibilité : une API dépréciée est retirée dès que quelqu’un s’en occupe, dans une version mineure, et le retrait est consigné dans le CHANGELOG.

Les dépréciations annoncées pour la prochaine majeure ne sont pas retenues jusqu’à la 3.0.0. C’est une règle pour le stade actuel du projet, pas une garantie permanente.

Ce que cette page ne promet pas

Cette page décrit comment les versions sont numérotées et annoncées. origam ne publie aucune ligne à support long terme, aucune fenêtre de support et aucun délai de réponse garanti.