read me updates
add some comments, general tidy-up