update doc with latest findings