Improved documentation in basics.rst.

Author: eduardo-rodrigues

docs/basics.rst

@@ -8,14 +8,11 @@ started, make sure that the development environment is set up to compile the
 included set of test cases.
 
 
-Compiling the test cases
-========================
+Quick start
+===========
 
-Linux/MacOS
------------
-
-On Linux you'll need the `Hydra`_, `Pybind11`_ and the **cmake**. Also, you will
-be requiring the **python-dev** or **python3-dev** package. You can clone
+On Linux you'll need the `Hydra`_ and `Pybind11`_ projects as well as **cmake** to build. The **python-dev** or **python3-dev** package is required too.
+You can clone
 and fetch the latest code for both of the mentioned libraries. Then you could
 create a directory structure similar to below one.
 
@@ -38,16 +35,15 @@ After downloading the prerequisites, run
    cmake -DHYDRA_INSTALL_PATH=../Hydra -DPYBIND11_INSTALL_PATH=../pybind11/include -DTHRUST_INSTALL_PATH=../Hydra ../Hydra.Python
    make all
 
-The last line will both compile and create a shared ``.so`` file which can be
-imported in the python.
+The last line will both compile and create a shared ``.so`` file which is the library imported in python.
 
 The best way to check if the installation is correct or not is to run the test
-cases provided in the Hydra.Python/tests.
+cases provided in the ``Hydra.Python/tests/`` directory.
 
-Creating simple Vector4R particle and calculate it's mass
-=========================================================
+Creating a simple Lorentz vector and calculating the particle's mass
+====================================================================
 
-Let's start by creating importing the module:
+Let's start by importing the module:
 
 .. code-block:: python
 
@@ -56,18 +52,16 @@ Let's start by creating importing the module:
 
 The name ``HydraPython`` is quite long so generally, we use its alias as ``hp``.
 
-Now that we have already imported the module let's just simply create a ``Vector4R``
-object.
+Now that we have already imported the module let's just simply create the particle Lorentz vector, i.e. the ``Vector4R`` instance.
 
 .. code-block:: python
 
     import HydraPython as hp
     vec4 = hp.Vector4R()
     print(vec4)  # (0, 0, 0, 0)
 
-So this is it. You just created a Vector4R object. The Vector4R object in Hydra
-is used as a ``particle``. This understanding is important when
-you will use the ``PhaseSpace`` class to generate the Events over N particles.
+So this is it. We've just created a ``Vector4R`` object represending the 4-momentum vector of a particle.
+This matter is important when the ``PhaseSpace`` class will be used to generate Events with N particles.
 
-The next 3 pages explain the Vector classes (``Vector4R`` and ``Vector3R``), ``Events``
+The next 3 pages explain the Vector classes (``Vector4R`` and ``Vector3R``), the ``Events``
 classes and the ``PhaseSpace`` class in more detail.