MINOR updates to README and code commments/tidying