diff --git a/docs/installation.rst b/docs/installation.rst
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -3,24 +3,24 @@
Installation
============
-``RhodeCode`` is written entirely in Python, but in order to use it's full
-potential there are some third-party requirements. When RhodeCode is used
-together with celery You have to install some kind of message broker,
+``RhodeCode`` is written entirely in Python. In order to gain maximum performance
+there are some third-party you must install. When RhodeCode is used
+together with celery you have to install some kind of message broker,
recommended one is rabbitmq_ to make the async tasks work.
-Of course RhodeCode works in sync mode also, then You don't have to install
-any third party apps. Celery_ will give You large speed improvement when using
-many big repositories. If You plan to use it for 7 or 10 small repositories, it
-will work just fine without celery running.
+Of course RhodeCode works in sync mode also and then you do not have to install
+any third party applications. However, using Celery_ will give you a large speed improvement when using
+many big repositories. If you plan to use RhodeCode for say 7 to 10 small repositories, RhodeCode
+will perform perfectly well without celery running.
-After You decide to Run it with celery make sure You run celeryd using paster
+If you make the decision to run RhodeCode with celery make sure you run celeryd using paster
and message broker together with the application.
-Install from Cheese Shop
+Installing RhodeCode from Cheese Shop
------------------------
-Rhodecode requires python 2.x greater than version 2.5
+Rhodecode requires python version 2.5 or higher.
-Easiest way to install ``rhodecode`` is to run::
+The easiest way to install ``rhodecode`` is to run::
easy_install rhodecode
@@ -28,8 +28,8 @@ Or::
pip install rhodecode
-If you prefer to install manually simply grab latest release from
-http://pypi.python.org/pypi/rhodecode, decompress archive and run::
+If you prefer to install RhodeCode manually simply grab latest release from
+http://pypi.python.org/pypi/rhodecode, decompress the archive and run::
python setup.py install
@@ -38,15 +38,13 @@ Step by step installation example
---------------------------------
-- Assuming You have installed virtualenv_ create one using.
-
-::
+- Assuming you have installed virtualenv_ create a new virtual environment using virtualenv::
virtualenv --no-site-packages /var/www/rhodecode-venv
.. note:: Using ``--no-site-packages`` when generating your
- virtualenv is *very important*. This flag provides the necessary
+ virtualenv is **very important**. This flag provides the necessary
isolation for running the set of packages required by
RhodeCode. If you do not specify ``--no-site-packages``,
it's possible that RhodeCode will not install properly into
@@ -56,48 +54,42 @@ Step by step installation example
- this will install new virtualenv_ into `/var/www/rhodecode-venv`.
-- Activate the virtualenv_ by running
-
-::
+- Activate the virtualenv_ by running::
source /var/www/rhodecode-venv/bin/activate
-.. note:: If you're on UNIX, *do not* use ``sudo`` to run the
+.. note:: If you're using UNIX, *do not* use ``sudo`` to run the
``virtualenv`` script. It's perfectly acceptable (and desirable)
to create a virtualenv as a normal user.
-- Make a folder for rhodecode somewhere on the filesystem for example
-
-::
+- Make a folder for rhodecode somewhere on the filesystem for example::
mkdir /var/www/rhodecode
-- Run this command to install rhodecode
-
-::
+- Run this command to install rhodecode::
easy_install rhodecode
-- this will install rhodecode together with pylons
- and all other required python libraries
+- This will install rhodecode together with pylons and all other required python
+ libraries
Requirements for Celery (optional)
----------------------------------
.. note::
Installing message broker and using celery is optional, RhodeCode will
- work without them perfectly fine.
+ work perfectly fine without them.
**Message Broker**
- preferred is `RabbitMq `_
-- possible other is `Redis `_
+- A possible alternative is `Redis `_
-For installation instructions You can visit:
-http://ask.github.com/celery/getting-started/index.html
-It's very nice tutorial how to start celery_ with rabbitmq_
+For installation instructions you can visit:
+http://ask.github.com/celery/getting-started/index.html.
+This is a very nice tutorial on how to start using celery_ with rabbitmq_
You can now proceed to :ref:`setup`