This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author veky
Recipients docs@python, gvanrossum, phr, rhettinger, veky
Date 2019-10-03.03:02:46
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1570071766.26.0.828187149069.issue38333@roundup.psfhosted.org>
In-reply-to
Content
In that case, I'm pretty sure you'd never be able to document almost _any_ function signature. Python is simply not a statically typed language, and we love it because of that.

Ok, go to the list of builtins, and start alphabetically. First is abs. What type does it take, and what type does it return? Again, I'd be completely ok with saying it takes an int, a float, or a complex, and returns either an int or a float. The same as the words in the docs already say. But according to Guido, that's "unacceptable", since abs can also take (and return) a datetime.timedelta, for example.

I am very afraid that if we start doing this, we will lose _many_ useful features that make Python the language it is. It's really not worth it.
History
Date User Action Args
2019-10-03 03:02:46vekysetrecipients: + veky, gvanrossum, rhettinger, phr, docs@python
2019-10-03 03:02:46vekysetmessageid: <1570071766.26.0.828187149069.issue38333@roundup.psfhosted.org>
2019-10-03 03:02:46vekylinkissue38333 messages
2019-10-03 03:02:46vekycreate