comments, readme.md update, code cleanup