From be292e7867d00be554e71493a18d1711dad8ae46 Mon Sep 17 00:00:00 2001
From: Johannes Raggam <raggam-nl@adm.at>
Date: Fri, 14 Feb 2014 15:10:19 +0100
Subject: [PATCH] we should not break old habbits. no dot btw version and
 status! and fix the precedence of version strings, which was stated wrong
 here.

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

diff --git a/docs/contribute/conventions.rst b/docs/contribute/conventions.rst
index 6b21c7f..0ba2a82 100644
--- a/docs/contribute/conventions.rst
+++ b/docs/contribute/conventions.rst
@@ -338,11 +338,19 @@ 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]
 
 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
+    1.0 < 1.1dev < 1.1a1 < 1.1a2 < 1.1b < 1.1rc1 < 1.1 < 1.1.1
+
+You can test it with setuptools::
+
+    >>> from pkg_resources import parse_version
+    >>> parse_version('1.0') < parse_version('1.1.dev')
+    ... < parse_version('1.1.a1') < parse_version('1.1.a2')
+    ... < parse_version('1.1.b') < parse_version('1.1.rc1')
+    ... < parse_version('1.1') < parse_version('1.1.1')
 
 Setuptools recommends to seperate parts with a dot. The website about `semantic
 versioning <http://semver.org/>`_ is also worth a read.