gh-89682: [doc] reword docstring of __contains__ to clarify that it returns a bool

[ivanistheone]

I was looking to implement a "custom object" to represent intervals of numbers

e.g. if x in interval(2,4) will be True if (x >= 2) and (x < 4).

I looked up help(list.__contains__) and it says "Return key in self" which I interpreted as returning the actual key, not a boolean. A moment of confusion ensured and I tested [2,3].__contains__(2) to check that return value of __contains__ is indeed boolean.

The docstring change suggestion makes the return type of __contains__ clearer.

A type hint for old school people who ? methods in jupyter notebooks ;)

• Issue: Minor docstring improvement in __contains__ #89682

[the-knights-who-say-ni]

Hello, and thanks for your contribution!

I'm a bot set up to make sure that the project can legally accept this contribution by verifying everyone involved has signed the PSF contributor agreement (CLA).

CLA Missing

Our records indicate the following people have not signed the CLA:

@ivanistheone

For legal reasons we need all the people listed to sign the CLA before we can look at your contribution. Please follow the steps outlined in the CPython devguide to rectify this issue.

If you have recently signed the CLA, please wait at least one business day
before our records are updated.

You can check yourself to see if the CLA has been received.

Thanks again for the contribution, we look forward to reviewing it!

[ivanistheone]

git diff --color-words for this PR

• red = words removed
• blue = words added

[github-actions]

This PR is stale because it has been open for 30 days with no activity.

[MaxwellDupre]

Looks ok.

[iritkatriel]

We'll need a news file for this. It's minor, but it touches a builtin.

[bedevere-bot]

Most changes to Python require a NEWS entry.

Please add it using the blurb_it web app or the blurb command-line tool.

[bedevere-bot]

Most changes to Python require a NEWS entry.

Please add it using the blurb_it web app or the blurb command-line tool.

[iritkatriel]

Thanks, I'll merge once CI completes.