doc improvements based on Jesse's comments