Update on the repo README.md documentation to improve some text/explanations.