Update CHANGES.rst

CHANGES.rst

@@ -7,6 +7,7 @@ Dependencies
 * #11411: Support `Docutils 0.21`_. Patch by Adam Turner.
 
 .. _Docutils 0.21: https://docutils.sourceforge.io/RELEASE-NOTES.html#release-0-21-2024-04-09
+* #12012: Use ``types-docutils`` instead of ``docutils-stubs``.
 
 Incompatible changes
 --------------------
@@ -22,59 +23,45 @@ Deprecated
   the public properties :attr:`!sphinx.testing.util.SphinxTestApp.status`
   and :attr:`!sphinx.testing.util.SphinxTestApp.warning` instead.
   Patch by Bénédikt Tran.
-* tests: :func:`!sphinx.testing.util.strip_escseq` is deprecated in favor of
+* tests: :func:`!sphinx.testing.util.strip_escseq` is deprecated in favour of
   :func:`!sphinx.util.console.strip_colors`.
   Patch by Bénédikt Tran.
 
 Features added
 --------------
 
-* Add public type alias :class:`sphinx.util.typing.ExtensionMetadata`.
-  This can be used by extension developers
-  to annotate the return type of their ``setup`` function.
-  Patch by Chris Sewell.
-
-* #12193: Improve ``external`` warnings for unknown roles.
-  In particular, suggest related role names if an object type is mistakenly used.
-  Patch by Chris Sewell.
-
-* #12131: Added :confval:`show_warning_types` configuration option.
-  Patch by Chris Sewell.
-
+* #12265: Support theme configuration via ``theme.toml``.
 * #11701: HTML Search: Adopt the new `\<search\>`_ element.
   Patch by Bénédikt Tran.
 
   .. _`\<search\>`: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/search
-
 * #11803: autodoc: Use an overriden ``__repr__()`` function in an enum,
   if defined. Patch by Shengyu Zhang.
-
-* #11892: Improved performance when resolving cross references in cpp domain.
+* #11892: Improved performance when resolving cross references in the C++ domain.
   Patch by Rouslan Korneychuk.
-
 * #11981: Improve rendering of signatures using ``slice`` syntax,
   e.g., ``def foo(arg: np.float64[:,:]) -> None: ...``.
-
 * The manpage builder now adds `OSC 8`_ anchors to hyperlinks, using
   the `groff`_ device control command.
 
   .. _OSC 8: https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda
   .. _groff: https://lists.gnu.org/archive/html/groff/2021-10/msg00000.html
-
-* #11015: :rst:dir:`versionadded` wording changes from ``New in [...]``
-  to ``Added in [...]``.
+* #11015: Change the text of the :rst:dir:`versionadded` directive from
+  ``New in [...]`` to ``Added in [...]``.
   Patch by Bénédikt Tran.
-
+* #12131: Added :confval:`show_warning_types` configuration option.
+  Patch by Chris Sewell.
+* #12193: Improve ``external`` warnings for unknown roles.
+  In particular, suggest related role names if an object type is mistakenly used.
+  Patch by Chris Sewell.
+* Add public type alias :class:`sphinx.util.typing.ExtensionMetadata`.
+  This can be used by extension developers
+  to annotate the return type of their ``setup`` function.
+  Patch by Chris Sewell.
 
 Bugs fixed
 ----------
 
-* #11959: Fix multiple term matching when word appears in both title and document.
-  Patch by Will Lachance.
-* #11958: HTML Search: Fix partial matches overwriting full matches.
-  Patch by William Lachance.
-* #11944: Use anchor in search preview.
-  Patch by Will Lachance.
 * #11668: Raise a useful error when ``theme.conf`` is missing.
   Patch by Vinay Sajip.
 * #11622: Ensure that the order of keys in ``searchindex.js`` is deterministic.
@@ -130,6 +117,12 @@ Bugs fixed
   Patch by Bénédikt Tran.
 * #12008: Fix case-sensitive lookup of ``std:label`` names in intersphinx inventory.
   Patch by Michael Goerz.
+* #11959: Fix multiple term matching when word appears in both title and document.
+  Patch by Will Lachance.
+* #11958: HTML Search: Fix partial matches overwriting full matches.
+  Patch by William Lachance.
+* #11944: Use anchor in search preview.
+  Patch by Will Lachance.
 * #11474: Fix doctrees caching causing files not be rebuilt in some cases,
   e.g., when :confval:`numfig` is ``True``.
   Patch by Bénédikt Tran.
@@ -163,18 +156,18 @@ Bugs fixed
 
 Testing
 -------
+
 * #11285: :func:`!pytest.mark.sphinx` and :class:`!sphinx.testing.util.SphinxTestApp`
   accept *warningiserror*, *keep_going* and *verbosity* as keyword arguments.
   Patch by Bénédikt Tran.
 * #11285: :class:`!sphinx.testing.util.SphinxTestApp` *status* and *warning*
   arguments are checked to be :class:`io.StringIO` objects (the public API
   incorrectly assumed this without checking it).
   Patch by Bénédikt Tran.
-
-* pytest: report the result of ``test_run_epubcheck`` as ``skipped`` instead of
-  ``success`` when Java and/or the ``epubcheck.jar`` code are not available.
-* utils: use dynamic allocation of unused port numbers for the test HTTP(S)
-  servers.  As a side-effect, this removes the need for test server lockfiles,
+* Report the result of ``test_run_epubcheck`` as ``skipped`` instead of
+  ``success`` when either Java or ``epubcheck`` are not available.
+* Use dynamic allocation of unused port numbers for the test HTTP(S) servers.
+  As a side-effect, this removes the need for test server lockfiles,
   meaning that any remaining ``tests/test-server.lock`` files can safely be
   deleted.