MAJOR.MINOR.PATCH (X.Y.Z)
- Increment when making incompatible API changes
- Represents breaking changes
- Examples: complete redesigns, removing features, changing how core functionality works
- Increment when adding functionality in a backward-compatible manner
- Represents new features that don't break existing functionality
- Examples: adding new sections, features, or capabilities
- Increment when making backward-compatible bug fixes
- Represents maintenance updates and small improvements
- Examples: fixing typos, adjusting colors, fixing broken links
- Pre-release versions can be denoted with a hyphen (e.g.,
1.0.0-alpha,1.0.0-beta.2) - Build metadata can be added with a plus sign (e.g.,
1.0.0+20240404) - Version numbers should never contain leading zeros
- Versions are compared numerically (e.g.,
1.10.0>1.9.0)
2.0.0: Major update with breaking changes1.1.0: Added new features (backward-compatible)1.0.1: Bug fixes and minor improvements1.0.0-alpha: Pre-release alpha version1.0.0-beta.2: Second beta pre-release