code review doc updates