gh-105052:update timeit function's description

[Cherrymelon]

Update time unit description in timeit function and add note to timeit doc page

• Issue: Documentation of timeit.Timer.timeit should mention that the return value depends on the timer #105052

[ghost]

All commit authors signed the Contributor License Agreement.

[terryjreedy]

The PR could have waited for more discussion on the issue. See this comment for what I think the most important change for this issue should be, and where.

The Timer docstring has an obsolete and now wrong statement about the timer that should be deleted: ; the timer function is platform-dependent (see the module doc string)

[bedevere-bot]

A Python core developer has requested some changes be made to your pull request before we can consider merging it. If you could please address their requests along with any other requests in other reviews from core developers that would be appreciated.

Once you have made the requested changes, please leave a comment on this pull request containing the phrase I have made the requested changes; please review again. I will then notify any core developers who have left a review that you're ready for them to take another look at this pull request.

[miss-islington]

Thanks @Cherrymelon for the PR, and @terryjreedy for merging it 🌮🎉.. I'm working now to backport this PR to: 3.11, 3.12.
🐍🍒⛏🤖

[bedevere-bot]

GH-108534 is a backport of this pull request to the 3.12 branch.

[bedevere-bot]

GH-108535 is a backport of this pull request to the 3.11 branch.