document why ip detection is implemented like this