diff --git a/README.rst b/README.rst
index e745462fb67cae58f04d8e7af31f35d629d35263..60e8276427c5cce82a01047755a9677d878c3da1 100644
--- a/README.rst
+++ b/README.rst
@@ -1,5 +1,5 @@
 ========
-flatland
+Flatland
 ========
 
 
@@ -15,37 +15,76 @@ flatland
 
 Multi Agent Reinforcement Learning on Trains
 
+Getting Started
+===============
+
 Generate Docs
 --------------
-     | The docs have a lot more details about how to interact with this codebase.   
-     | **TODO**: Mohanty to add atleast a neat outline herefor the contents to the docs here.
-
-     .. code-block:: bash
 
-          git clone git@gitlab.aicrowd.com:flatland/flatland.git
-          cd flatland
-          pip install -r requirements_dev.txt
+The docs have a lot more details about how to interact with this codebase.  
 
-     * Linux and macOS
+**TODO**: Mohanty to add atleast a neat outline herefor the contents to the docs here ::
 
-          .. code-block:: bash
+    git clone git@gitlab.aicrowd.com:flatland/flatland.git
+    cd flatland
+    pip install -r requirements_dev.txt
 
-               make docs
+* On, Linux and macOS ::
 
+    make docs
 
-     * Windows
 
-          .. code-block:: bash
+* On, Windows ::
 
-               python setup.py develop (or)
-               python setup.py install
-               python make_docs.py
+    python setup.py develop (or)
+    python setup.py install
+    python make_docs.py
 
 
 Features
 --------
 
-* TODO
+TODO
+
+
+Installation
+============
+
+Stable Release
+--------------
+
+To install flatland, run this command in your terminal ::
+
+    pip install flatland-rl
+
+This is the preferred method to install flatland, as it will always install the most recent stable release.
+
+If you don’t have `pip <https://pip.pypa.io/en/stable/>`_ installed, this `Python installation guide <https://docs.python-guide.org/starting/installation/>`_ can guide you through the process.
+
+
+From Sources
+------------
+The sources for flatland can be downloaded from the `Gitlab repo <https://gitlab.aicrowd.com/flatland/flatland>`_.
+
+You can clone the public repository ::
+
+    $ git clone git@gitlab.aicrowd.com:flatland/flatland.git
+
+Once you have a copy of the source, you can install it with ::
+
+    $ python setup.py install
+    
+    
+Usage
+=====
+To use flatland in a project ::
+    
+    import flatland
+    
+flatland
+========
+TODO: explain the interface here
+
 
 Authors
 --------
@@ -55,5 +94,7 @@ Authors
 * Jeremy Watson
 * Erik Nygren <erik.nygren@sbb.ch>
 * Adrian Egli <adrian.egli@sbb.ch>
+* Vaibhav Agrawal <theinfamouswayne@gmail.com>
+
 
 <please fill yourself in>