Adding docs
Extending readme
First draft readme finished. Examples updaed for clarity.