Release Management

Best Practices

Articles

Naming Conventions

Versioning

Most common model:

  • X.0 for Major releases
  • X.X.0 for minor releases
  • X.X.X.0 for patches that don’t include functionality updates.
  • X.X.X.X for security and/or emergency patches.

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

  • MAJOR version when you make incompatible API changes,
  • MINOR version when you add functionality in a backwards-compatible manner, and
  • 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.

Other models:

Tools

Gitver

A very simple, lightweight, tag-based version string manager for git, written in Python.

Homepage: https://github.com/manuelbua/gitver