Semantic Versioning (SemVer)
A version number of the form major.minor.patch and the rules for when each part increments, so dependency declarations mean the same thing to everyone.
Canonical text: https://semver.org/spec/v2.0.0.html, read against version 2.0.0. In use on this site: github.com/manifesto-md/manifesto.md/blob/main/CHANGELOG.md.
The rule
- Major version when you make incompatible API changes.
- Minor version when you add functionality in a backward compatible manner.
- Patch version when you make backward compatible bug fixes.
- Pre-release and build metadata are available as extensions.
Facts
- Maintainer
- Tom Preston-Werner and the semver maintainers
- Repository
- https://github.com/semver/semver
- Licence of the text
- CC BY 3.0
- First published
- 2013-06-18
- Status of the text
- stable
- Listing
- listed, not yet claimed
Read with
-
Conventional Commits
A lightweight convention on top of commit messages, type, scope and description, that machines and people can read and that maps onto semantic versions.
-
Keep a Changelog
A format for a changelog file that people can read, one entry per version, grouped by the kind of change, newest first.
Badge
[](https://manifesto.md/semver/) Maintainers claim a listing with a pull request setting listing: claimed, or a yes on the listing issue.