add some comments and update README