code review corrects and update readme further