doc modifications requested in code review