Using __new__ was made an error 8 years ago, keeping this in the docs just causes confusion at this point (e.g. #2311).