Vedran Čačić <ved...@gmail.com> added the comment:

> Many docs are ... vague about types.

... and I consider that a feature. At least if you do that, make an explicit 
decision not to introduce TypeErrors for "disagreeing with the documented 
signature".

For example, I'd be ok with sum being documented as taking an iterable of 
numbers and returning a number, but it would be a catastrophe if as a 
consequence of that, sum of a list of lists would stop working.

----------
nosy: +veky

_______________________________________
Python tracker <rep...@bugs.python.org>
<https://bugs.python.org/issue38333>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to