From 6c2d802b5b293617a6252149800743b54ed64c18 Mon Sep 17 00:00:00 2001
From: Johannes Raggam <raggam-nl@adm.at>
Date: Wed, 6 Nov 2013 01:06:23 +0100
Subject: [PATCH] update on versioning scheme

---
 docs/contribute/conventions.rst | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/docs/contribute/conventions.rst b/docs/contribute/conventions.rst
index b617fff..29a5eb3 100644
--- a/docs/contribute/conventions.rst
+++ b/docs/contribute/conventions.rst
@@ -319,11 +319,17 @@ Inside each group of dependencies, lines should be sorted alphabetically.
 Versioning scheme
 =================
 
-For software versions, use a sequence-based versioning scheme::
+For software versions, use a sequence-based versioning scheme, which is
+`compatible with setuptools <http://pythonhosted.org/setuptools/setuptools.html#specifying-your-project-s-version>`::
 
-    MAJOR.MINOR[.MICRO][STATUS]
+    MAJOR.MINOR[.MICRO].[STATUS]
 
-For more information, read http://semver.org/.
+The way, setuptools interprets versions is intuitive::
+
+    1.0 < 1.1.a1 < 1.1.a2 < 1.1.b < 1.1.dev < 1.1.rc1 < 1.1.rcdev < 1.1 < 1.1.1
+
+Setuptools recommends to seperate parts with a dot. The website about `semantic
+versioning <http://semver.org/>` is also worth a read.
 
 
 Restructured Text versus Plain Text