Documentation and examples

[analyticalmonk]

There's a need to document the code as well as update the README/Wiki with examples. Since I have gone through the code and worked with it, I can put in some improvements and submit a PR.