add comments and update readme file