Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Browse files

Add versioning document

  • Loading branch information...
commit 385e69027f6f00eabe0940d84c79a9c986654031 1 parent edbe25a
@DasIch authored
Showing with 30 additions and 0 deletions.
  1. +1 −0  docs/index.rst
  2. +29 −0 docs/other/versioning.rst
1  docs/index.rst
@@ -45,5 +45,6 @@ Additional Notes
+ other/versioning.rst
29 docs/other/versioning.rst
@@ -0,0 +1,29 @@
+pwhash versions allow for three different kinds of releases: major, minor and
+bugfix releases that are encoded as `major.minor.bugfix` in the version. Each
+type of release makes it possible to quickly ascertain which kinds of changes
+have been made and how that affects compatibilty.
+Major releases are made whenever a backwards incompatible change has been
+introduced, minor releases are made whenever a new feature has been introduced
+and bugfix releases are made whenever a bugfix has been introduced.
+In other words when using pwhash make sure to declare it as a dependency in a
+way that prevents the install mechanism to use a different pwhash version it
+was intended for. If you want to support multiple major releases you should run
+your tests with both.
+Which versions are maintained or supported is decided based on a simple set of
+1. Bugfix releases are made for all supported minor versions.
+2. The latest minor versions of all supported major versions are supported.
+3. Minor releases are made for the latest major version.
+4. The latest major version is supported.
+5. The major version prior to the last major version is supported at most until
+ a minor release has been made.
Please sign in to comment.
Something went wrong with that request. Please try again.