doc updates based on review
review fixes