document why this works