typo and doc fix in response to code review