Improve the NEWS entry for UserDict.popitem()

Andrew5057 · Andrew5057 · commit 9f4625ca1990 · 2026-04-03T18:33:53.000-05:00
Makes better use of reST constructs and uses better language.
diff --git a/Misc/NEWS.d/next/Library/2026-04-01-07-10-49.gh-issue-147957.QXf5Xx.rst b/Misc/NEWS.d/next/Library/2026-04-01-07-10-49.gh-issue-147957.QXf5Xx.rst
@@ -1 +1,2 @@
-Causes the ``popitem`` method for ``collections.UserDict`` to pop in last-in, first-out order rather than first-in, first-out. The former has been the default for ``dict`` instances since Python 3.7, so this change will make subclasses of ``UserDict`` behave more like ``dict``.
+Guarantees that the CPython implementation of :meth:`collections.UserDict.popitem` will pop in the same order as the wrapped dictionary rather than an arbitrary order.
+This change will make :class:`UserDict` instances behave more similarly to :class:`dict` (or whichever mapping type the instance is customized to use).

Original file line number	Diff line number	Diff line change
`@@ -1 +1,2 @@`
`1`		-Causes the ``popitem`` method for ``collections.UserDict`` to pop in last-in, first-out order rather than first-in, first-out. The former has been the default for ``dict`` instances since Python 3.7, so this change will make subclasses of ``UserDict`` behave more like ``dict``.
	`1`	+Guarantees that the CPython implementation of :meth:`collections.UserDict.popitem` will pop in the same order as the wrapped dictionary rather than an arbitrary order.
	`2`	+This change will make :class:`UserDict` instances behave more similarly to :class:`dict` (or whichever mapping type the instance is customized to use).