update doc to reflect latest changes