rewrite of README.md and adding comments