Reword the documentation

Author: encukou

Doc/library/enum.rst

@@ -828,19 +828,21 @@ Data Types
 
 .. class:: EnumDict
 
-   *EnumDict* is a subclass of :class:`dict` that keeps track of the order of enum members and prevents reusing member names. Use *EnumDict* when member names must be unique and their order needs to be preserved.
+   *EnumDict* is a subclass of :class:`dict` that is used as the namespace
+   for defining enum classes (see :ref:`prepare`).
+   It is exposed to allow subclasses of :class:`EnumType` with advanced
+   behavior like having multiple values per member.
+   It prevents reusing member names, with special behavior for names that
+   start with an underscore.
+
+   Note that only the :class:`~collections.abc.MutableMapping` interface
+   (:meth:`~object.__setitem__` and :meth:`~dict.update`) is overridden.
+   It may be possible to bypass the checks using other :class:`!dict`
+   operations like :meth:`|= <object.__ior__>`.
 
    .. attribute:: EnumDict.member_names
 
-      Return list of member names.
-
-   .. method:: EnumDict.__setitem__(self, key, value)
-
-      Set any item as an enum member that is not dundered and not a descriptor.
-
-   .. method:: EnumDict.update(self, members, **more_members)
-
-      Update the dictionary from the given iterable or dictionary members and more_members.
+      A list of member names.
 
    .. versionadded:: 3.13
 

Doc/whatsnew/3.13.rst

@@ -745,7 +745,9 @@ email
 enum
 ----
 
-* :class:`~enum.EnumDict` has been made public in :mod:`enum`.
+* :class:`enum.EnumDict` has been made public, in order to allow subclasses
+  of :class:`~enum.EnumType` with advanced behavior like having multiple values
+  per member.
 
 fractions
 ---------

Misc/NEWS.d/next/Library/2024-09-04-14-13-14.gh-issue-121720.z9hhXQ.rst

@@ -0,0 +1,2 @@
+:class:`enum.EnumDict` can now be used on its own, without resorting to
+private API.