Apply suggestions from code review

Co-authored-by: Hugo van Kemenade <[email protected]>

Author: vstinner

peps/pep-0814.rst

@@ -12,7 +12,7 @@ Abstract
 A new public immutable type ``frozendict`` is added to the ``builtins``
 module.
 
-We expect frozendict to be safe by design, as it prevents any unintended
+We expect ``frozendict`` to be safe by design, as it prevents any unintended
 modifications. This addition benefits not only CPython’s standard
 library, but also third-party maintainers who can take advantage of a
 reliable, immutable dictionary type.
@@ -34,18 +34,18 @@ desirable:
 
 * This hashable property permits functions decorated with
   ``@functools.lru_cache()`` to accept immutable mappings as arguments.
-  Unlike an immutable mapping, passing a plain dict to such a function
+  Unlike an immutable mapping, passing a plain ``dict`` to such a function
   results in error.
 
-* Using an immutable mapping as a function parameter default value
+* Using an immutable mapping as a function parameter's default value
   avoids the problem of mutable default values.
 
 * Immutable mappings can be used to safely share dictionaries across
   thread and asynchronous task boundaries. The immutability makes it
   easier to reason about threads and asynchronous tasks.
 
-There are already multiple existing 3rd party ``frozendict`` and
-``frozenmap`` available on PyPI, proving that there is a need for
+There are already third-party ``frozendict`` and ``frozenmap`` packages
+available on PyPI, proving that there is demand for
 immutable mappings.
 
 
@@ -60,9 +60,9 @@ module. It is not a ``dict`` subclass but inherits directly from
 Construction
 ------------
 
-``frozendict`` implements a dict-like construction API:
+``frozendict`` implements a ``dict``-like construction API:
 
-* ``frozendict()`` creates a new empty immutable mapping;
+* ``frozendict()`` creates a new empty immutable mapping.
 
 * ``frozendict(**kwargs)`` creates a mapping from ``**kwargs``,
   e.g. ``frozendict(x=1, y=2)``.
@@ -99,12 +99,12 @@ Hashing
     hash(frozendict(foo='bar'))  # works
     hash(frozendict(foo=['a', 'b', 'c']))  # error, list is not hashable
 
-The hash value does not depend on the items order. It is computed on
+The hash value does not depend on the items' order. It is computed on
 keys and values. Pseudo-code of ``hash(frozendict)``::
 
     hash(frozenset(frozendict.items()))
 
-Equality test does not depend on the items order neither. Example::
+Equality test does not depend on the items' order neither. Example::
 
     >>> a = frozendict(x=1, y=2)
     >>> b = frozendict(y=2, x=1)
@@ -117,7 +117,7 @@ Equality test does not depend on the items order neither. Example::
 Typing
 ------
 
-It is possible to use the standard typing notation for frozendicts::
+It is possible to use the standard typing notation for ``frozendict``\ s::
 
     m: frozendict[str, int] = frozendict(x=1)
 
@@ -143,7 +143,7 @@ Add the following APIs:
 * ``PyFrozenDict_CheckExact()`` macro
 
 Even if ``frozendict`` is not a ``dict`` subclass, it can be used with
-``PyDict_GetItemRef()`` and similiar "PyDict_Get" functions.
+``PyDict_GetItemRef()`` and similar "PyDict_Get" functions.
 
 Passing a ``frozendict`` to ``PyDict_SetItem()`` or ``PyDict_DelItem()``
 fails with ``TypeError``. ``PyDict_Check()`` on a ``frozendict`` is
@@ -156,8 +156,8 @@ containers to make thread-safe very easily. It will be important since
 accepted, people need this for their migration.
 
 
-Differences between dict and frozendict
-=======================================
+Differences between ``dict`` and ``frozendict``
+===============================================
 
 * ``dict`` has more methods than ``frozendict``:
 
@@ -173,8 +173,8 @@ Differences between dict and frozendict
   and values can be hashed.
 
 
-Possible candidates for frozendict in the stdlib
-================================================
+Possible candidates for ``frozendict`` in the stdlib
+====================================================
 
 We have identified several stdlib modules where adopting ``frozendict``
 can enhance safety and prevent unintended modifications by design. We
@@ -233,16 +233,16 @@ Replace ``dict`` with ``frozendict`` for constants:
 Relationship to PEP 416 frozendict
 ==================================
 
-Since 2012 (PEP 416), the Python ecosystem evolved:
+Since 2012 (:pep:`416`), the Python ecosystem evolved:
 
 * ``asyncio`` was added in 2014 (Python 3.4)
-* Free Threading was added in 2024 (Python 3.13)
+* Free threading was added in 2024 (Python 3.13)
 * ``concurrent.interpreters`` was added in 2025 (Python 3.14)
 
 There are now more use cases to share immutable mappings.
 
 ``frozendict`` now preserves the insertion order, whereas PEP 416
-``frozendict`` was unordered (as PEP 603 ``frozenmap``). ``frozendict``
+``frozendict`` was unordered (as :pep:`603` ``frozenmap``). ``frozendict``
 relies on the ``dict`` implementation which preserves the insertion
 order since Python 3.6.
 
@@ -268,12 +268,12 @@ Relationship to PEP 603 frozenmap
   * ``excluding(key)``
   * ``union(mapping=None, **kw)``
 
-==========  =============  ==============
-Complexity  ``frozenmap``  ``frozendict``
-==========  =============  ==============
-Lookup      O(log n)       O(1)
-Copy        O(1)           O(n)
-==========  =============  ==============
+==========  ==============  ==============
+Complexity  ``frozenmap``   ``frozendict``
+==========  ==============  ==============
+Lookup      *O*\ (log *n*)  *O*\ (1)
+Copy        *O*\ (1)        *O*\ (*n*)
+==========  ==============  ==============
 
 
 Reference Implementation
@@ -319,8 +319,8 @@ If ``frozendict`` does not inherit from ``dict``, there is no such
 issue.
 
 
-New syntax for frozendict literals
-----------------------------------
+New syntax for ``frozendict`` literals
+--------------------------------------
 
 Various syntaxes have been proposed to write ``frozendict`` literals.
 
@@ -337,7 +337,7 @@ References
 Acknowledgements
 ================
 
-This PEP is based on prior work from Yury Selivanov (PEP 603).
+This PEP is based on prior work from Yury Selivanov (:pep:`603`).
 
 
 Copyright