docs & nits from code review