Semantic Versioning
Semantische Versionierung
Semantische Versionierung (SemVer) verwendet MAJOR.MINOR.PATCH-Nummern, um zu zeigen, wie sich eine öffentliche API geändert hat. Sie legt auch Regeln für Pre-Release- und Build-Labels fest.
Ein weiteres Beispiel
Eine Bibliothek ist bei Version 2.4.1 und fügt eine API hinzu, die weiterhin mit altem Code funktioniert. Der Wartende veröffentlicht Version 2.5.0 und dokumentiert die Hinzufügung. Ohne eine angegebene öffentliche API können diese Zahlen keine klare Kompatibilität versprechen.
Hauptteile
- 01öffentliche API
- 02Kompatibilitätsänderung
- 03Versionskennung
Verwenden Sie es, wenn
Verwenden Sie diesen Begriff für Software mit einer angegebenen öffentlichen API, deren Versionsnummern Kompatibilitätsänderungen zeigen.
Nutze es nicht, wenn
Schätzen Sie die Produktqualität, das Veröffentlichungsdatum oder den Upgrade-Aufwand nicht nur anhand einer SemVer-Nummer.
In Code verwendeter Name
MAJOR.MINOR.PATCH[-prerelease][+build] Vor dem Ausliefern
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 Semantische Versionierung (Semantic Versioning). User context: Eine Bibliothek ist bei Version 2.4.1 und fügt eine API hinzu, die weiterhin mit altem Code funktioniert. Der Wartende veröffentlicht Version 2.5.0 und dokumentiert die Hinzufügung. Ohne eine angegebene öffentliche API können diese Zahlen keine klare Kompatibilität versprechen. Technology or engineering concept: Semantische Versionierung (Semantic Versioning). Why it fits: Verwenden Sie diesen Begriff für Software mit einer angegebenen öffentlichen API, deren Versionsnummern Kompatibilitätsänderungen zeigen. Do not use it when: Schätzen Sie die Produktqualität, das Veröffentlichungsdatum oder den Upgrade-Aufwand nicht nur anhand einer SemVer-Nummer. 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): Ein formelles Dokument kann trotzdem ein Entwurf, ein Release Candidate oder die finale Version sein. Prüfe seinen Status und die Browser- oder Plattform-Unterstützung. Unknowns to confirm: Current stack, runtime and version rules, target systems, dependency owner, performance budget, support period, and migration limits.
Diese Anfrage prüfen
Review how Semantische Versionierung (Semantic Versioning) is used now. Definition: Semantische Versionierung (SemVer) verwendet MAJOR.MINOR.PATCH-Nummern, um zu zeigen, wie sich eine öffentliche API geändert hat. Sie legt auch Regeln für Pre-Release- und Build-Labels fest. 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.