update(docs): editorial changes to readme docs