From 46eb7ece0697bf21bbaca05d87c6399f981a1d57 Mon Sep 17 00:00:00 2001
From: Rodolphe Marques <rodolphe@ascribe.io>
Date: Tue, 9 Feb 2016 19:56:52 +0100
Subject: [PATCH] Install instructions for bigchain

---
 docs/source/installing.md          | 63 ++++++++++++++++++++++++++++--
 docs/source/the-bigchain-class.rst |  4 +-
 2 files changed, 62 insertions(+), 5 deletions(-)

diff --git a/docs/source/installing.md b/docs/source/installing.md
index dbc4f80c..39b7d780 100644
--- a/docs/source/installing.md
+++ b/docs/source/installing.md
@@ -1,7 +1,64 @@
 # Installing BigchainDB
 
-Link to RethinkDB installation instructions
+BigchainDB works on top of [rethinkDB](http://rethinkdb.com/) server. In order to use
+BigchainDB we first need to install rethinkDB server.
 
-How to install BigchainDB
+##### Installing and running rethinkDB server on Ubuntu >= 12.04
 
-Installing with Docker?
+Rethinkdb provides binaries for all major distros. For ubuntu we only need to
+add the [RethinkDB repository](http://download.rethinkdb.com/apt/) to our list
+of repositories and install via `apt-get`
+
+```shell
+source /etc/lsb-release && echo "deb http://download.rethinkdb.com/apt
+$DISTRIB_CODENAME main" | sudo tee /etc/apt/sources.list.d/rethinkdb.list
+wget -qO- https://download.rethinkdb.com/apt/pubkey.gpg | sudo apt-key add -
+sudo apt-get update
+sudo apt-get install rethinkdb
+```
+
+For more information, rethinkDB provides [detailed
+instructions](http://rethinkdb.com/docs/install/) on how to install in a variety
+of systems.
+
+RethinkDB does not require any special configuration. To start rethinkdb server
+just run this command on the terminal.
+
+```shell
+$ rethinkdb
+```
+
+##### Installing and running BigchainDB
+BigchainDB is distributed as a python package. Installing is simple using `pip`
+
+```shell
+$ pip install bigchaindb
+```
+
+After installing BigchainDB we can run it with:
+
+```shell
+$ bigchaindb start
+```
+
+During the first run BigchainDB takes care of configuring a single node
+environment.
+
+##### Installing from source
+
+BigchainDB is in its early stages and being actively developed on its [GitHub
+repository](https://github.com/BigchainDB/bigchaindb). Contributions are highly
+appreciated.
+
+Clone the public repository
+```shell
+$ git clone git@github.com:BigchainDB/bigchaindb.git
+```
+
+Install from the source
+```shell
+$ python setup.py install
+```
+
+##### Installing with Docker?
+Coming soon...
diff --git a/docs/source/the-bigchain-class.rst b/docs/source/the-bigchain-class.rst
index 1b32108c..105a7ed2 100644
--- a/docs/source/the-bigchain-class.rst
+++ b/docs/source/the-bigchain-class.rst
@@ -4,7 +4,7 @@ The Bigchain Class
 
 The Bigchain class is the top-level API for BigchainDB. If you want to create and initialize a BigchainDB database, you create a Bigchain instance (object). Then you can use its various methods to create transactions, write transactions (to the object/database), read transactions, etc.
 
-.. autoclass:: bigchain.Bigchain
+.. autoclass:: bigchaindb.Bigchain
    :members:
 
-   .. automethod:: bigchain.core.Bigchain.__init__
+   .. automethod:: bigchaindb.core.Bigchain.__init__