misc doc changes requested during code review