update doc for issues 2