[docs] Deficiencies in type hint usage in Python standard libraries

[John Michael Lafayette]

I love the new type hint feature in Jetbrains IDE (PEP 0484). Now when my
user defined methods return a value, I can press (Crtl+space) and see the
type of that value and all its methods. Also, when I pass the wrong type
in, I get a warning.

Oddly, this does not happen with Python standard library functions. I can't
get the auto-complete on objects returned by the Python standard library.
The Python standard library doesn't warn me in advance if I put the wrong
type in a method. How does that make sense? Please support PEP 0484 by
using it in the Python standard library where appropriate.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20151011/4cd699e4/attachment.html>