updated readme with new comments