doc update from feedback