Merge lp:~nigelbabu/summit/docs-cleaning into lp:summit

[Nigel Babu]

Spring cleaning the docs in readthedocs.org.

Spring cleaning the docs in readthedocs.org.

[Michael Hall (mhall119)]

Looks good to me

review: Approve

=== modified file 'docs/installing.rst'
--- docs/installing.rst	2011-09-14 02:32:31 +0000
+++ docs/installing.rst	2011-11-10 14:50:31 +0000
@@ -2,7 +2,7 @@
 Installing Summit
 ==================
 
-efore you start hacking on summit, you need to first setup your environment.
+Before you start hacking on summit, you need to first setup your environment.
 We're going to set it up without breaking anything else in your current.
 
 
@@ -12,22 +12,15 @@
  * Python 2.6 (greater than 2.6.1)
  * virtualenv
 
-On Ubuntu
-~~~~~~~~~
-The following command will install the required development files on Ubuntu or,
-if you're running a recent version, you can `install them automatically
-<apt:python-virtualenv>`_::
-
-    sudo apt-get install python-virtualenv
-
 virtualenv
-----------
-
+~~~~~~~~~~
 `virtualenv <http://pypi.python.org/pypi/virtualenv>`_ is a tool to create
 isolated Python environments.  We don't want to install packages system-wide
-because that can create quite a mess. ::
+because that can create quite a mess.  The following command will install the
+required development files on Ubuntu or, if you're running a recent version,
+you can `install them automatically <apt:python-virtualenv>`_::
 
-    sudo easy_install virtualenv
+    sudo apt-get install python-virtualenv
 
 virtualenv is the only Python package you need to install system-wide.
 Everything else goes in a virtual environment.
@@ -38,7 +31,14 @@
 `virtualenvwrapper <http://www.doughellmann.com/docs/virtualenvwrapper/>`_
 is a set of shell functions that make virtualenv easy to work with.
 
-Install it like this::
+For Ubuntu Maverick Meerkat and above, `install virtualenvwrapper via apt
+<apt:virtualenvwrapper>`_::
+
+    sudo apt-get install virtualenvwrapper
+
+Once installed, ``exec bash`` and you're set to start!
+
+For earlier releases, install it like this::
 
     wget http://bitbucket.org/dhellmann/virtualenvwrapper/raw/f31869779141/virtualenvwrapper_bashrc -O ~/.virtualenvwrapper
     mkdir ~/.virtualenvs
@@ -86,7 +86,7 @@
 .. note:: If you want to use a different Python binary, pass the path to
           mkvirtualenv with ``--python``::
 
-            mkvirtualenv --python=/usr/local/bin/python2.6 --no-site-packages summit
+            mkvirtualenv --python=/usr/bin/python2.6 --no-site-packages summit
 
 Finish the install
 ~~~~~~~~~~~~~~~~~~
@@ -110,10 +110,10 @@
 Get themes
 ----------
 
-Get the theme for Ubuntu and Linaro with::
+Get setup for the themes for Ubuntu and Linaro::
 
-    bzr branch lp:ubuntu-community-webthemes/light-django-theme ubuntu_website
-    bzr branch lp:~linaro-infrastructure/ubuntu-community-webthemes/light-django-linaro-theme linaro_website
+    ./manage.py init-summit
+    ./manage.py pullapps
 
 Database
 --------