Politique de version · Documentation

RéférencePolitique de version

Pourquoi le versioning est importantLien vers la section

PyColors utilise le Versioning sémantique pour rendre les mises à jour prévisibles, sûres et faciles à comprendre.

Un numéro de version doit communiquer immédiatement :

Le niveau de changement
risque de mise à niveau
Compatibilité Attentes
les besoins migratoires

Cette politique vise à réduire l’incertitude dans l’ensemble de l’écosystème.

Principe de base

Les développeurs devraient être en mesure de comprendre l'impact de la mise à niveau avant de lire le journal des modifications.

Référence du versioning sémantiqueLien vers la section

Les packages PyColors, les starters, les templates et les outils partagés suivent Semantic Versioning.

semver.txt

MAJOR.MINOR.PATCH

Patch

Corrections, polissage, mises à jour de la documentation, maintenance sécurisée des dépendances et petites améliorations de l'expérience utilisateur sans modifications majeures.

Mineur

Nouvelles fonctionnalités, API, modèles, flux de travail ou composants qui restent rétrocompatibles.

Majeur

Briser les changements nécessitant une migration, des mises à jour d'architecture ou des modifications d'API incompatibles.

Règles de type de publicationLien vers la section

publication des correctifs

Patch releases improve stability, polish, and maintainability without changing expected integrations or workflows.

bug fixes
documentation improvements
small UI polish
dependency-safe maintenance
performance optimizations

Example: 1.0.4 → 1.0.5

Interprétation pratiqueLien vers la section

En pratique, le type de version répond à une question :

L'utilisateur peut-il effectuer une mise à niveau en toute sécurité sans migration ?

Situation	Type de publication
Réparer les bugs ou polir	Patch
Ajout de fonctionnalités rétrocompatibles	Mineur
Exiger la migration ou changer la compatibilité	Majeur

Importante distinction

Une grande quantité de travail ne signifie pas automatiquement une publication majeure. Le facteur déterminant est l'impact de la compatibilité.

Ce qui n’est pas une publication majeureLien vers la section

Les modifications suivantes restent généralement des versions patch ou mineures :

Visuel polonais
documentation restructuration
Refactors internes
amélioration des performances
nouvelles API optionnelles
nouvelles sections de démarrage
Améliorations du système de conception additive

Une version ne devient majeure que lorsque les attentes en matière de compatibilité changent.

Objectifs de versionLien vers la section

Cette politique est conçue pour fournir :

Mises à jour prévisibles
attentes de compatibilité transparentes
Consommation de colis stable
frontières migratoires claires
adoption à long terme plus sûre
Confiance plus forte des développeurs

Principe de confiance

Le versioning stable fait partie de l’expérience produit, pas seulement un détail technique.

Relation avec les rejets de l'écosystèmeLien vers la section

Versioning sémantique s'applique aux versions de paquets techniques.

L'écosystème plus large de PyColors communique les progrès séparément par :

Libérations hebdomadaires
changelog mises à jour
Progression de le panneau latéral de route
annonces d'écosystèmes

Cette séparation permet de garder la vérité technique précise tout en facilitant la progression du produit.

Source de véritéLien vers la section

Surface	Objet
GitHub	Détails de la version technique
`CHANGELOG.md`	Changements au niveau du package
`/changelog`	Progrès des écosystèmes
`/roadmap`	Direction à venir

Politique de publicationComprendre comment PyColors envoie les mises à jour à travers l'écosystème.Historique des versionsSuivez les progrès de l'écosystème et relâchez la cadence.Sheet de routeDécouvrez ce qui est prévu sur la plateforme.UI docsExplorez le système de conception et les composants PyColors.