Tidy up repo and provide more details in our README so people are able
to understand the project, and get started a lot more easily.