update doc and notes