Semantic Versioning
Versionnage sémantique
Le versionnage sémantique (SemVer) utilise les numéros MAJOR.MINOR.PATCH pour montrer comment une API publique a changé. Il définit également des règles pour les étiquettes de préversion et de build.
Un autre exemple
Une bibliothèque est à 2.4.1 et ajoute une API qui fonctionne toujours avec l'ancien code. Le responsable publie la version 2.5.0 et enregistre l'ajout. Sans API publique indiquée, ces numéros ne peuvent pas clairement garantir la compatibilité.
Parties principales
- 01API publique
- 02Changement de compatibilité
- 03identifiant de version
Utilisez-le lorsque
Utilisez ce terme pour un logiciel avec une API publique déclarée dont les numéros de version montrent les changements de compatibilité.
Ne l'utilisez pas lorsque
Ne devinez pas la qualité du produit, la date de sortie ou le travail de mise à jour à partir d'un numéro SemVer seul.
Nom utilisé dans le code
MAJOR.MINOR.PATCH[-prerelease][+build] Avant d'expédier
Check the runtime and version, integration limits, dependencies and licenses, and platform support. Verify security, failure, speed, monitoring, deploy, support owner, upgrade path, and rollback.
Outcome: Complete the task with Versionnage sémantique (Semantic Versioning). User context: Une bibliothèque est à 2.4.1 et ajoute une API qui fonctionne toujours avec l'ancien code. Le responsable publie la version 2.5.0 et enregistre l'ajout. Sans API publique indiquée, ces numéros ne peuvent pas clairement garantir la compatibilité. Technology or engineering concept: Versionnage sémantique (Semantic Versioning). Why it fits: Utilisez ce terme pour un logiciel avec une API publique déclarée dont les numéros de version montrent les changements de compatibilité. Do not use it when: Ne devinez pas la qualité du produit, la date de sortie ou le travail de mise à jour à partir d'un numéro SemVer seul. Engineering fit: Define where it runs and which version to use. Set its job, interfaces, data flow, dependencies, supported systems, security, and speed limits. Explain how it fits the current stack. Lifecycle safeguards: Check dependency health and licenses. Add monitoring and a fallback. Name the upgrade owner. Do not add a second tool for the same job without a measured benefit. Acceptance criteria: A small integration proves the needed behavior. Test compatibility, security, failure, and performance. Document deploy, upgrade, support, and rollback steps. Evidence and limits (evidence boundary): Un document officiel peut quand même être un brouillon, un release candidate, ou la version finale. Vérifie son statut et sa compatibilité avec le navigateur ou la plateforme. Unknowns to confirm: Current stack, runtime and version rules, target systems, dependency owner, performance budget, support period, and migration limits.
Vérifiez cette demande
Review how Versionnage sémantique (Semantic Versioning) is used now. Definition: Le versionnage sémantique (SemVer) utilise les numéros MAJOR.MINOR.PATCH pour montrer comment une API publique a changé. Il définit également des règles pour les étiquettes de préversion et de build. Release checks: Check the runtime and version, integration limits, dependencies and licenses, and platform support. Verify security, failure, speed, monitoring, deploy, support owner, upgrade path, and rollback. Before changing code, list the evidence, gaps, severity, and the smallest safe fix.