Rewrote README

The README has been updated now that the documentation has been moved to
read the docs to follow the model described at
http://williamdurand.fr/2013/07/04/on-open-sourcing-libraries/.