docs update
adding updates from DOC review