Major documentation improvements and bug fixes.

Signed-off-by: Piotr Carewicz <piotr.carewicz@gmail.com>