Performance improvement to uuid8 on “What’s New” page

[JostMigenda]

Documentation

The What’s new in Python 3.14 page currently states:

uuid4() and uuid8() are 30% and 40% faster respectively.

For uuid4, I’d interpret that as “faster than in Python 3.13”; but for uuid8, which is new in 3.14 as mentioned a few paragraphs earlier on the same page, the comparison is not clear.

Looking at GitHub, initial support for uuid8 was merged in November 2024 and the performance improvements were merged in January 2025; so this is effectively a performance comparison between 3.14a2 and 3.14a4. Perhaps that’s something that should not be included in user-facing documentation?

Linked PRs

• gh-136428: amend UUIDv8 performance improvements #136903
• [3.14] gh-136428: amend UUIDv8 performance improvements (GH-136903) #136904

[StanFromIreland]

cc @picnixz

Also, meta issue: #123299

[picnixz]

Hum yes. I think we can remove those improvements notices for uuid8 now that we're in the last beta. They are documented in the full changelog which has exact versioning but in the whatsnew, we shouldn't refer to the new features to avoid confusion

[rozeappletree]

I can make changes ro the docs. Shall I send a PR?

@picnixz @StanFromIreland

[StanFromIreland]

Yes, you can send a PR:-) Please note our policy on generative ai.

[picnixz]

Yes and if you can also update the performance numbers, please do so. There should be a benchmark script somewhere in the issue or PR that mentioned it so reuse that script (and build Python with PGO and LTO support). I wouldn't want to lie to the readers.

If you don't know how to make benchmarks, I'll update the docs myself.