fixes typos and clarified language
formatting readme
updates docs