minor clean up of the README file and the start of some documentation