update readme.md based on dbevenius feedback
update based on matzew feedback
Merge branch 'AGPUSH-925'