update doc wrt previous changes