updated doc to incorperate feedback.