README improvements
along with some cosmetic changes in few other files