doc review updates