From c310892cf82ec3cb15dbf45a038c4ac441e84d45 Mon Sep 17 00:00:00 2001
From: KVGarg <co16326.ccet@gmail.com>
Date: Sun, 13 Jan 2019 15:38:44 +0530
Subject: [PATCH] README.rst: Add Build and Development instructions

---
 README.rst | 91 ++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 89 insertions(+), 2 deletions(-)

diff --git a/README.rst b/README.rst
index 519d839..24f8289 100644
--- a/README.rst
+++ b/README.rst
@@ -70,9 +70,95 @@ We appreciate any help!
 BUILD & DEVELOPMENT
 -------------------
 
-Run ``python3 setup.py install``
+1. Installation instructions for **Windows** users:
 
-Note: You need to have bower installed before you may install the python packages.
+   - Clone the **coala-html** repository
+
+     ::
+
+       $ git clone https://github.com/coala/coala-html.git
+
+   - Download and install the latest version of Node.js from `official website <https://nodejs.org/en/download/>`__.
+
+   - Change the directory to **coala-html** and run following command to install dependencies
+
+     ::
+
+       $ python setup.py install
+
+   - Install **coala-bears**
+
+     ::
+
+       $ pip install coala-bears
+
+   - Install **bower** to build static web pages
+
+     ::
+
+       $ npm install -g bower
+
+
+   - Run **coala-html** to display results from **coala-json**
+
+     ::
+
+       $ coala-html --dir ..\Tests
+
+
+2. Installation instructions for **Linux** users:
+
+   - Clone the **coala-html** repository
+
+     ::
+
+      $ git clone https://github.com/coala/coala-html.git
+
+   - Install latest version of **Node.js**
+
+     Refer `official guide <https://nodejs.org/en/download/package-manager/>`__, for installing Node.js via Package manager.
+
+   - *Check Node.js and npm version*
+
+     You can find more details about current version on node.js `official website <https://nodejs.org/>`__.
+
+     ::
+
+       $ node -v
+
+       $ npm -v
+
+   - Install **bower** to build static web pages
+
+     ::
+
+       $ sudo npm install -g bower
+
+   - Change the directory to **coala-html** and run following command to install dependencies
+
+     ::
+
+       $ python3 setup.py install
+
+   - Install **coala-bears**
+
+     ::
+
+       $ pip3 install coala-bears
+
+   - Change ownership to install packages required by bower
+
+     ::
+
+       $ sudo chown -R $USER:$GROUP ~/.config/configstore
+
+   - Run **coala-html** to display results from **coala-json**
+
+     ::
+
+       $ coala-html --dir ./coala_test_results
+
+For more details on using, refer to the usage_ section.
 
 LICENSE
 =======
@@ -93,3 +179,4 @@ your option) any later version.
    :target: https://codecov.io/github/coala/coala-html?branch=master
 .. _GIF: https://cloud.githubusercontent.com/assets/7397433/16225501/8162a2a4-37c4-11e6-96b8-3e37b705c7f3.gif
 .. _Live: http://coala.github.io/coala-html
+.. _usage: https://github.com/coala/coala-html#usage