proofreading notes from @erikdesjardins

whoops, neglected to put this on the original PR