feedback from @rbeagrie, mostly additional explanation detail