Skip to content

Instantly share code, notes, and snippets.

@gandhiShepard

gandhiShepard/SemanticVersioning.md

Created August 30, 2014 16:24
Show Gist options
  • Save gandhiShepard/ce5358e9b8608d0b6dbb to your computer and use it in GitHub Desktop.
Save gandhiShepard/ce5358e9b8608d0b6dbb to your computer and use it in GitHub Desktop.
Download ZIP
Raw
SemanticVersioning.md

Semantic Versioning 2.0.0

Summary

Given a version number MAJOR.MINOR.PATCH, increment the:

  1. MAJOR version when you make incompatible API changes,
  2. MINOR version when you add functionality in a backwards-compatible manner, and
  3. PATCH version when you make backwards-compatible bug fixes.

Additional labels for pre-release and build metadata are available as extensions to the MAJOR.MINOR.PATCH format.

  • Version 1.0.0 defines the public API.

FAQ

How should I deal with revisions in the 0.y.z initial development phase?

The simplest thing to do is start your initial development release at 0.1.0 and then increment the minor version for each subsequent release.

The Semantic Versioning specification is authored by Tom Preston-Werner, inventor of Gravatars and cofounder of GitHub.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment