improvements to the readme
merged readme update into dev from master