Author veky
Recipients docs@python, gvanrossum, phr, rhettinger, veky
Date 2019-10-01.06:42:22
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1569912143.0.0.669955016968.issue38333@roundup.psfhosted.org>
In-reply-to
Content
> 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.
History
Date User Action Args
2019-10-01 06:42:23vekysetrecipients: + veky, gvanrossum, rhettinger, phr, docs@python
2019-10-01 06:42:22vekysetmessageid: <1569912143.0.0.669955016968.issue38333@roundup.psfhosted.org>
2019-10-01 06:42:22vekylinkissue38333 messages
2019-10-01 06:42:22vekycreate