Semantic Versioning and Release Management Cheat Sheet

Semantic Versioning (SemVer) is a widely adopted versioning convention that attaches explicit meaning to version numbers, enabling predictable dependency management and clear communication about software changes. Codified as a formal specification at semver.org, it structures versions as MAJOR.MINOR.PATCH to signal breaking changes, new features, and bug fixes respectively. Beyond the core numbering system, modern release management encompasses complementary practices including calendar-based versioning schemes (CalVer), conventional commit standards that automate version bumping, lock files that guarantee reproducible builds, and sophisticated tooling (semantic-release, changesets, git-cliff) that orchestrates the entire release workflow. One critical insight often overlooked: version precedence rules treat pre-release versions (e.g., 1.0.0-alpha) as lower than their release counterpart (1.0.0), meaning pre-releases are never selected by dependency resolvers unless explicitly requested—a behavior that shapes how teams orchestrate alpha, beta, and RC promotion workflows.