updated the readme for grammar and ambiguities

Docs edits for clarity and grammar