update readme file and code comments