update doc about possible mistake