documenting the overload logic on client translation