software-development icon indicating copy to clipboard operation
software-development copied to clipboard

Document standards for version numbers and releases

Open jchodera opened this issue 6 years ago • 3 comments

It would be useful to have standards for versioning and release naming conventions.

jchodera avatar Aug 07 '18 21:08 jchodera

I agree. I suggest semantic versioning.

From the documentation:

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.

augeorge avatar Sep 26 '18 00:09 augeorge

The Python standard: https://www.python.org/dev/peps/pep-0440/

ctk3b avatar Sep 26 '18 01:09 ctk3b

Thanks everyone! Anyone want to contribute some recommended text?

jchodera avatar Sep 26 '18 01:09 jchodera