README update as well as code comments