Semantic Versioning
Versionamento Semantico
Il Versionamento Semantico (SemVer) usa numeri MAGGIORE.MINORE.PATCH per mostrare come è cambiata un’API pubblica. Stabilisce anche regole per etichette di prerelease e build.
Un altro esempio
Una libreria è alla versione 2.4.1 e aggiunge un'API che funziona ancora con il codice vecchio. Il manutentore rilascia la 2.5.0 e registra l'aggiunta. Senza un'API pubblica dichiarata, questi numeri non possono promettere chiaramente la compatibilità.
Parti principali
- 01API pubblica
- 02modifica di compatibilità
- 03identificatore di versione
Usalo quando
Usa questo termine per software con un'API pubblica dichiarata i cui numeri di rilascio indicano cambiamenti di compatibilità.
Non usarlo quando
Non indovinare la qualità del prodotto, la data di rilascio o il lavoro di aggiornamento basandoti solo su un numero SemVer.
Nome usato nel codice
MAJOR.MINOR.PATCH[-prerelease][+build] Prima di spedire
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 Versionamento Semantico (Semantic Versioning). User context: Una libreria è alla versione 2.4.1 e aggiunge un'API che funziona ancora con il codice vecchio. Il manutentore rilascia la 2.5.0 e registra l'aggiunta. Senza un'API pubblica dichiarata, questi numeri non possono promettere chiaramente la compatibilità. Technology or engineering concept: Versionamento Semantico (Semantic Versioning). Why it fits: Usa questo termine per software con un'API pubblica dichiarata i cui numeri di rilascio indicano cambiamenti di compatibilità. Do not use it when: Non indovinare la qualità del prodotto, la data di rilascio o il lavoro di aggiornamento basandoti solo su un numero SemVer. 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 documento formale può ancora essere una bozza, un release candidate o la versione finale. Controlla il suo stato e il supporto per browser o piattaforma. Unknowns to confirm: Current stack, runtime and version rules, target systems, dependency owner, performance budget, support period, and migration limits.
Controlla questa richiesta
Review how Versionamento Semantico (Semantic Versioning) is used now. Definition: Il Versionamento Semantico (SemVer) usa numeri MAGGIORE.MINORE.PATCH per mostrare come è cambiata un’API pubblica. Stabilisce anche regole per etichette di prerelease e 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.