On Sat, 24 Dec 2022 at 13:15, Cameron Simpson <c...@cskk.id.au> wrote:
> >wording that clarifies whether x.upper() uppercases the string
> >in-place?
>
> Well, it says "a copy", so I'd say it's clear.
>
My question was more: do you know, or do you have to look? I'll take
another example. Take the list.index() method, which returns the index
where a thing can be found. *Without checking first*, answer these
questions:
1) Will identical-but-not-equal values (eg the same instance of nan) be found?
2) Do the docs and/or docstring tell you the answer to question 1?
And then a logical followup:
3) If your answer to question 1 was incorrect, {does it help, would it
have helped} to have a note in the docs?
ChrisA
_______________________________________________
Python-ideas mailing list -- python-ideas@python.org
To unsubscribe send an email to python-ideas-le...@python.org
https://mail.python.org/mailman3/lists/python-ideas.python.org/
Message archived at
https://mail.python.org/archives/list/python-ideas@python.org/message/J33BJF75LI3PH4ISNBJ3AIGZALBECJIB/
Code of Conduct: http://python.org/psf/codeofconduct/
