README.md and documentation updated

Author: stephenhky

README.md

@@ -1 +1,21 @@
 # graphflow : Algorithms for Graph Flow Analysis
+
+This Python package provides numerical routines for graph flow analysis, particularly:
+
+* PageRank
+* Linear System of Resistance
+* Non-linear System of Resistance
+
+# Installation
+
+You must have `numpy` pre-installed. GCC and GFORTRAN compilers have to be available in the machine.
+After ensuring they have been installed, type the following to install `graphflow`:
+
+```
+>>> pip install -U graphflow
+```
+
+# News
+
+* 06/06/2018: `graphflow` 0.1.2 released.
+* 04/12/2018: `graphflow` 0.1.1 released.

doc/source/index.rst

@@ -9,8 +9,9 @@ Welcome to GraphFlow's documentation!
 Contents:
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
+   intro
    news
 
 Indices and tables

doc/source/intro.rst

@@ -0,0 +1,16 @@
+Introduction to graphflow
+=========================
+
+This Python package provides numerical routines for graph flow analysis, particularly:
+
+* PageRank
+* Linear System of Resistance
+* Non-linear System of Resistance
+
+Author: Kwan-Yuet Ho (LinkedIn_, ResearchGate_, Twitter_)
+
+Home: :doc:`index`
+
+.. _LinkedIn: https://www.linkedin.com/in/kwan-yuet-ho-19882530
+.. _ResearchGate: https://www.researchgate.net/profile/Kwan-yuet_Ho
+.. _Twitter: https://twitter.com/stephenhky