About semver validator
Semantic versioning writes versions as MAJOR.MINOR.PATCH. The validator checks a version and shows its parts.
What the numbers mean
- MAJOR changes when there are incompatible API changes.
- MINOR adds features in a backward-compatible way.
- PATCH fixes bugs without changing the API.
- Pre-release tags like 1.0.0-beta.1 sit before the release.
A worked example
The version 2.4.1-beta.3+build.7 is valid: major 2, minor 4, patch 1, pre-release beta.3 and build metadata build.7. The version 1.2 is not valid semantic versioning, because it lacks a patch number, and 01.2.3 is invalid because of the leading zero.
What each part promises
- Patch: bug fixes only, safe to upgrade.
- Minor: new features that keep working with old code.
- Major: breaking changes, so read the notes first.
Pre-release order
Pre-release versions sort in a defined order: 1.0.0-alpha comes before 1.0.0-alpha.1, then 1.0.0-beta, then 1.0.0-rc.1 and finally 1.0.0.
