revision to readme, formatting notes