Updating readme with more info

Adding how,when, and why to the project. I have also added some
examples to illustrate usage.

Now all it needs it more work :-P