As with many entries on the os.path doc page, splitext needs a typical example. Not grokking the bare minimum text, I had to actually try it in the interpreter to see what it did.

The one example that *is* there is an edge case, and does nothing to explain the normal behavior, or why this is the correct behavior for the edge case.

Here is where I tripped up:

Split the pathname path into a pair (root, ext) such that root + ext == path, and ext is empty or begins with a period and contains at most one period.

One interpretation of this is that ext is either empty, or has a period, _and nothing else_. 

Here are 2 examples for typical use:

>>> splitext('readme.txt')
('readme', '.txt')
>>> splitext('/some/long/pathname/warble.csv')
('/some/long/pathname/warble', '.csv')

Hello, I would like to submit a PR for this.

It'll be my first contribution to cPython and I am slightly unclear if this suggestion has been "accepted" in some sense (i.e. do the Devs agree it should be fixed as suggested)?

If so, I will go ahead and create PR (and credit shaungriffith for his provided examples).

@jstockwin, the process usually goes like this:

1. You open a PR
2. The discussion continues over there. non-core-dev volunteers review your PR and get it into a polished state.
3. A core dev will quickly take a look, provide feedback if necessary, or just merge if not.

There's no need to credit anyone – if Shaun wanted credit, he could have included a PR with his bug report! Plus, the commit will include this bpo#, so future onlookers can always trace the commit back to this thread.

Follow the dev guide as you go and don't hesitate to post any questions you have right here!

Thanks for the info, @jack__d - very helpful.
I have now submitted a PR for this and will await a review. Let me know if anything else is needed.

New changeset aa0894b3792901adb91e5f6d049154b7bcb980ec by Jake Stockwin in branch 'main':
bpo-35183: Add typical examples to os.path.splitext docs (GH-27286)
https://github.com/python/cpython/commit/aa0894b3792901adb91e5f6d049154b7bcb980ec

New changeset e0d599fa48032eb7b8d837f8412bbca72b6ad820 by Miss Islington (bot) in branch '3.9':
bpo-35183: Add typical examples to os.path.splitext docs (GH-27286) (GH-27564)
https://github.com/python/cpython/commit/e0d599fa48032eb7b8d837f8412bbca72b6ad820

New changeset 14cb669357bc30bdc235d1c32ee1b99be05ac9d8 by Miss Islington (bot) in branch '3.10':
bpo-35183: Add typical examples to os.path.splitext docs (GH-27286) (GH-27563)
https://github.com/python/cpython/commit/14cb669357bc30bdc235d1c32ee1b99be05ac9d8

Thanks, Jake! ✨ 🍰 ✨