From ef7012abd61940cb8e31194fecb716681aa55d75 Mon Sep 17 00:00:00 2001
From: Konsta Vesterinen <konsta.vesterinen@gmail.com>
Date: Thu, 30 Jan 2014 13:13:24 +0200
Subject: [PATCH] Add installation instructions

---
 docs/index.rst        |  1 +
 docs/installation.rst | 53 +++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 54 insertions(+)
 create mode 100644 docs/installation.rst

diff --git a/docs/index.rst b/docs/index.rst
index 946bc84..943179b 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -8,6 +8,7 @@ SQLAlchemy-Utils provides custom data types and various utility functions for SQ
 .. toctree::
    :maxdepth: 2
 
+   installation
    listeners
    data_types
    range_data_types
diff --git a/docs/installation.rst b/docs/installation.rst
new file mode 100644
index 0000000..27fb3bf
--- /dev/null
+++ b/docs/installation.rst
@@ -0,0 +1,53 @@
+Installation
+============
+
+This part of the documentation covers the installation of SQLAlchemy-Utils.
+
+Supported platforms
+-------------------
+
+SQLAlchemy-Utils has been tested against the following Python platforms.
+
+- cPython 2.6
+- cPython 2.7
+- cPython 3.3
+
+
+Installing an official release
+------------------------------
+
+You can install the most recent official SQLAlchemy-Utils version using
+pip_::
+
+    pip install sqlalchemy-utils
+
+.. _pip: http://www.pip-installer.org/
+
+Installing the development version
+----------------------------------
+
+To install the latest version of SQLAlchemy-Utils, you need first obtain a
+copy of the source. You can do that by cloning the git_ repository::
+
+    git clone git://github.com/kvesteri/sqlalchemy-utils.git
+
+Then you can install the source distribution using the ``setup.py``
+script::
+
+    cd sqlalchemy-utils
+    python setup.py install
+
+.. _git: http://git-scm.org/
+
+Checking the installation
+-------------------------
+
+To check that SQLAlchemy-Utils has been properly installed, type ``python``
+from your shell. Then at the Python prompt, try to import SQLAlchemy-Utils,
+and check the installed version:
+
+.. parsed-literal::
+
+    >>> import sqlalchemy_utils
+    >>> sqlalchemy_utils.__version__
+    |release|