update doc and diagram