updated README.md
added comments, notes, and explanations in the following files