[issue35544] unicode.encode docstring says return value can be unicode

[radiocane]

radiocane <bruno at anche.no> added the comment:

>> I'll keep on finding "-> string or unicode" misleading.
> How is it misleading when its true?

[I promise this is the last reply: I won't waste more of your time]

me: How fast does this car go?
docstring: 100 km/h or 300 km/h

me: actually most people use it to do 100km/h and I don't know how to do 300 km/h
people: no physical law forbids 300 km/h so it's true
people2: if you remove the seats, the lights, the windshield etc and basically end up with a chassis with four wheels and a motor, it can do 300 km/h

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35544>
_______________________________________