Document our explicit Python version support.

dhermes · dhermes · commit e3ffb1eab8b6 · 2014-11-24T13:53:18.000-08:00
diff --git a/README.rst b/README.rst
@@ -92,6 +92,37 @@ Contributions to this library are always welcome and highly encouraged.
 See `CONTRIBUTING <CONTRIBUTING.rst>`__ for more information on how to
 get started.
 
+Supported Python Versions
+-------------------------
+
+We support:
+
+-  `Python 2.6 <https://docs.python.org/2.6/>`__
+-  `Python 2.7 <https://docs.python.org/2.7/>`__
+
+We plan to support:
+
+-  `Python 3.3 <https://docs.python.org/3.3/>`__
+-  `Python 3.4 <https://docs.python.org/3.4/>`__
+
+Supported versions can be found in our ``tox.ini``
+`config <https://github.com/GoogleCloudPlatform/gcloud-python/blob/master/tox.ini>`__.
+
+We explicitly decided not to support
+`Python 2.5 <https://docs.python.org/2.5/>`__ due to
+`decreased usage <https://caremad.io/2013/10/a-look-at-pypi-downloads/>`__ and
+lack of continuous integration
+`support <http://blog.travis-ci.com/2013-11-18-upcoming-build-environment-updates/>`__.
+
+We also explicitly decided to support Python 3 beginning with version 3.3.
+Reasons for this include:
+
+-  Encouraging use of newest versions of Python 3
+-  Taking the lead of prominent open-source
+   `projects <http://flask.pocoo.org/docs/0.10/python3/>`__
+-  Unicode literal `support <https://www.python.org/dev/peps/pep-0414>`__ which
+   allows for a cleaner codebase that works in both Python 2 and Python 3.
+
 License
 -------
 
