README.md

doc updates
mostly search and replace