Document the package in the readme.

I've started to write a readme.

Not sure how to describe the intent of the package in a good way

@senny @phgross 

Closes #2 
Includes documentation for #4