Tidying up comments in code for consistency and copying into first draft of documentation in README.md.