Tidied up top-level documentation
Merge pull request #120 from nslater/top-level-docs

Tidy up top-level documentation