From 88753e4370d1c721b3f433a02e6d34b923893c59 Mon Sep 17 00:00:00 2001
From: Karl Hobley <karlhobley10@gmail.com>
Date: Wed, 11 Feb 2015 17:55:35 +0000
Subject: [PATCH] Installation docs

---
 .../getting_started/creating_your_project.rst |  3 +-
 docs/getting_started/installation.rst         | 34 +++++++++++++++++--
 2 files changed, 33 insertions(+), 4 deletions(-)

diff --git a/docs/getting_started/creating_your_project.rst b/docs/getting_started/creating_your_project.rst
index 322218223d..6dd60700ef 100644
--- a/docs/getting_started/creating_your_project.rst
+++ b/docs/getting_started/creating_your_project.rst
@@ -2,8 +2,7 @@
 Starting your first project
 ===========================
 
-Once you've installed Wagtail, you are ready start your first project.
-
+Once you've installed Wagtail, you are ready start your first project. Wagtail projects are ordinary Django projects with a few extra apps installed.
 
 Wagtail provides a command to get you started called ``wagtail start``. Open up a command line shell in your project folder and type:
 
diff --git a/docs/getting_started/installation.rst b/docs/getting_started/installation.rst
index 9fd94f43e3..3714f5bc33 100644
--- a/docs/getting_started/installation.rst
+++ b/docs/getting_started/installation.rst
@@ -14,14 +14,44 @@ Whether you just want to try out the demo site, or you're ready to dive in and c
 Install Python
 ==============
 
-We recommend installing Python 3.4, but Wagtail also works with Python 2.7 and 3.3.
+If you haven't got Python installed yet, we recommend installing Python 3.4. You can find the download for it here: https://www.python.org/downloads/
 
 
+pip
+---
+
+Python 3.4 has this built in. If you are using Python 2.7 or 3.3, you will have to install PIP separately
+
+See: https://pip.pypa.io/en/latest/installing.html
+
+
+Virtual environments
+--------------------
+
+Python 3.3 and 3.4 has this built in. If you are using Python 2.7 you will have to install the ``virtualenv`` package from pip:
+
+.. code-block:: bash
+
+    pip install virtualenv
+
 
 Install Wagtail
 ===============
 
-``pip install wagtail``
+Wagtail is available as a pip-installable package. To get the latest stable version:
+
+.. code-block:: bash
+
+    pip install wagtail
+
+
+To check that Wagtail can be seen by Python. Type ``python`` in your shell then try to import ``wagtail`` from the prompt:
+
+.. code-block:: python
+
+    >>> import wagtail
+    >>> print(wagtail.get_version())
+    0.9
 
 
 Optional extras