Vik/add documentation

* Switch documentation over to RST
* Add in sphinx support
* Switch around README file a bit

Upshot is that users can now use sphinx to build very nice documentation.  The next step is to add more documentation, and host the generated documentation somewhere (Readthedocs or github pages spring to mind)