Suggestions to main Install page in documentation.

Author: adia

installation.rst

@@ -10,22 +10,22 @@ There are three ways to install Conan:
 
 1. The preferred and **strongly recommended way to install Conan** is from PyPI, the Python Package Index, using the ``pip`` command.
 2. There are other available installers for different systems, which might come with a bundled python interpreter, so that you don't have to
-   install python first. Please note that some of **these installers might have some limitations**, specially those created with pyinstaller
+   install python first. Note that some of **these installers might have some limitations**, specially those created with pyinstaller
    (such as Windows exe & Linux deb).
-3. Running conan from sources.
+3. Running Conan from sources.
 
 Install with pip (recommended)
 ------------------------------
 
-To install Conan using ``pip``, you need a python 2.7 or 3.X distribution installed in your machine. Modern python distros come 
+To install Conan using ``pip``, you need Python 2.7 or 3.X distribution installed on your machine. Modern Python distros come
 with pip pre-installed. However, if necessary you can install pip by following the instructions in `pip docs`_.
 
 .. warning::
 
-    Python 2 will by deprecated soon by the Python maintainers. It is strongly recommended to use Python 3 for conan, especially if need to manage non-ascii filenames or file contents.
-    Conan still supports Python 2, but some of the dependencies have started to be Python 3 only too. The roadmap for deprecating Python 2 support in Conan will be defined soon.
+    Python 2 will soon be deprecated by the Python maintainers. It is strongly recommended to use Python 3 with Conan, especially if need to manage non-ascii filenames or file contents.
+    Conan still supports Python 2, however some of the dependencies have started to be supported only by Python 3. The roadmap for deprecating Python 2 support in Conan will be defined soon.
 
-Install conan:
+Install Conan:
 
 .. code-block:: bash
 
@@ -35,20 +35,20 @@ Install conan:
 
     **Please READ carefully**
 
-    - Make sure that your **pip** installation matches your **python (2.7 or 3.X)** one.
-    - In Linux if you want to install it globally, you might need **sudo** permissions.
-    - We strongly recommend using **virtualenvs** (virtualenvwrapper works great) for everything python related
-    - In **Windows** and with Python 2.7, you might need to use **32bits** python distribution (which is the Windows default one), instead
-      of 64 bits.
-    - In **OSX**, specially latest versions that might have **System Integrity Protection**, pip might fail. Try with virtualenvs, or
-      install with other user ``$ pip install --user conan``.
-    - If you are in Windows, and using python <3.5, you might have problems if python is installed in a path with spaces, like
-      "C:/Program Files(x86)/Python". This is a known python's limitation, not Conan's. Install python in a path without spaces, use a
-      virtualenv in another location or upgrade your python installation.
-    - In some Linux distros, like Linux Mint, it is possible that you need a restart (shell restart, or logout/system if not enough) after
+    - Make sure that your **pip** installation matches your **Python (2.7 or 3.X)** version.
+    - In **Linux**, you may need **sudo** permissions to install Conan globally.
+    - We strongly recommend using **virtualenvs** (virtualenvwrapper works great) for everything related to Python.
+    - In **Windows** and Python 2.7, you may need to use **32bit** python distribution (which is the Windows default), instead
+      of 64 bit.
+    - In **OSX**, especially the latest versions that may have **System Integrity Protection**, pip may fail. Try using virtualenvs, or
+      install with another user ``$ pip install --user conan``.
+    - If you are using Windows and Python <3.5, you may have issues if Python is installed in a path with spaces, such as
+      "C:/Program Files(x86)/Python". This is a known Python limitation, and is not related to Conan. Try installing Python in a path without spaces, use a
+      virtualenv in another location or upgrade your Python installation.
+    - Some Linux distros, such as Linux Mint, require a restart (shell restart, or logout/system if not enough) after
       installation, so Conan is found in the path.
-    - Windows, Python 3 installation can fail installing the ``wrapt`` dependency because a bug in **pip**. Information about the issue and 
-      workarounds is here: https://github.com/GrahamDumpleton/wrapt/issues/112. 
+    - Windows, Python 3 installation can fail installing the ``wrapt`` dependency because of a bug in **pip**. Information about this issue and
+      workarounds is available here: https://github.com/GrahamDumpleton/wrapt/issues/112.
 
 Install from brew (OSX)
 -----------------------
@@ -90,13 +90,13 @@ Execute the installer. You don't need to install python.
 Initial configuration
 ---------------------
 
-Let's check if conan is correctly installed. In your console, run the following:
+Check if Conan is installed correctly. Run the following command in your console:
 
 .. code-block:: bash
 
     $ conan
 
-You will see something similar to:
+The response should be similar to:
 
 .. code-block:: bash
 
@@ -110,7 +110,7 @@ You will see something similar to:
 Install from source
 -------------------
 
-You can run conan directly from source code. First you need to install Python 2.7 or Python 3 and
+You can run Conan directly from source code. First, you need to install Python 2.7 or Python 3 and
 pip.
 
 Clone (or download and unzip) the git repository and install its requirements: