semanticversioning

Semantic Versioning, often abbreviated as SemVer, is a formal convention for assigning version numbers to software. It aims to convey meaning about the underlying changes in the code with each new release. The core of SemVer is a three-part version number: MAJOR.MINOR.PATCH.

The MAJOR version is incremented when incompatible API changes are made. This means that code written for a previous MAJOR version may not work with the new one without modifications. The MINOR version is incremented when new functionality is added in a backwards-compatible manner. Existing code should continue to function as before. The PATCH version is incremented for backwards-compatible bug fixes.

Pre-release versions can be indicated by appending a hyphen and a series of dot-separated identifiers. For example, 1.0.0-alpha.1. Build metadata can also be appended after a plus sign, such as 1.0.0+build20231027, but this metadata does not affect version precedence.

SemVer provides a clear and consistent way for developers and users to understand the implications of updating a piece of software. It helps in managing dependencies and avoiding unexpected breakages. By adhering to SemVer, projects can build trust and facilitate smoother development cycles.