add comments and update README