PEP 8108: Consistent use of backticks for coroutinedispatch in documentation

Author: rroblf01

peps/pep-8108.rst

@@ -8,12 +8,12 @@ Created: 16-Nov-2025
 Abstract
 ========
 
-This PEP proposes the addition of a `coroutinedispatch` class to the `functools` module in Python's standard library. The `coroutinedispatch` class enables method overloading based on argument types, supporting both synchronous and asynchronous methods. This feature simplifies the implementation of polymorphic behavior in Python, making it easier to write clean and maintainable code.
+This PEP proposes the addition of a ``coroutinedispatch`` class to the ``functools`` module in Python's standard library. The ``coroutinedispatch`` class enables method overloading based on argument types, supporting both synchronous and asynchronous methods. This feature simplifies the implementation of polymorphic behavior in Python, making it easier to write clean and maintainable code.
 
 Motivation
 ==========
 
-Python currently lacks built-in support for method overloading based on argument types. While developers can achieve similar functionality using conditional statements or external libraries, these approaches often result in verbose and less readable code. Adding a `coroutinedispatch` class to the standard library would:
+Python currently lacks built-in support for method overloading based on argument types. While developers can achieve similar functionality using conditional statements or external libraries, these approaches often result in verbose and less readable code. Adding a ``coroutinedispatch`` class to the standard library would:
 
 - Provide a standardized and Pythonic way to implement method overloading.
 - Enhance code readability and maintainability.
@@ -22,16 +22,16 @@ Python currently lacks built-in support for method overloading based on argument
 Rationale
 =========
 
-The `coroutinedispatch` class leverages Python's type hints and introspection capabilities to match method implementations based on argument types. This design aligns with Python's dynamic nature while encouraging the use of type annotations. By integrating this functionality into the `functools` module, we ensure consistency with other utility features for functional programming.
+The ``coroutinedispatch`` class leverages Python's type hints and introspection capabilities to match method implementations based on argument types. This design aligns with Python's dynamic nature while encouraging the use of type annotations. By integrating this functionality into the ``functools`` module, we ensure consistency with other utility features for functional programming.
 
 Specification
 =============
 
-The `coroutinedispatch` class will be implemented as follows:
+The ``coroutinedispatch`` class will be implemented as follows:
 
-- **Registration of Methods**: Developers can register multiple implementations of a method using the `@coroutinedispatch` decorator. The decorator inspects the argument types of the decorated function and stores the implementation accordingly.
-- **Type Matching**: When the method is called, the `coroutinedispatch` class matches the provided arguments against the registered implementations. If no exact match is found, a `TypeError` is raised.
-- **Support for Async Methods**: The `coroutinedispatch` class distinguishes between synchronous and asynchronous contexts, allowing developers to define separate implementations for each.
+- **Registration of Methods**: Developers can register multiple implementations of a method using the ``@coroutinedispatch`` decorator. The decorator inspects the argument types of the decorated function and stores the implementation accordingly.
+- **Type Matching**: When the method is called, the ``coroutinedispatch`` class matches the provided arguments against the registered implementations. If no exact match is found, a ``TypeError`` is raised.
+- **Support for Async Methods**: The ``coroutinedispatch`` class distinguishes between synchronous and asynchronous contexts, allowing developers to define separate implementations for each.
 
 Example Usage
 -------------
@@ -73,22 +73,22 @@ Example Usage
 Backwards Compatibility
 =======================
 
-This proposal introduces a new class to the `functools` module and does not modify any existing functionality. As such, it is fully backwards compatible.
+This proposal introduces a new class to the ``functools`` module and does not modify any existing functionality. As such, it is fully backwards compatible.
 
 Security Implications
 =====================
 
-The `coroutinedispatch` class relies on Python's type hints and introspection capabilities. It does not introduce any new security risks beyond those inherent to dynamic type checking.
+The ``coroutinedispatch`` class relies on Python's type hints and introspection capabilities. It does not introduce any new security risks beyond those inherent to dynamic type checking.
 
 How to Teach This
 =================
 
-The `coroutinedispatch` class should be documented in the Python standard library reference, with examples demonstrating its usage. Tutorials and guides on functional programming in Python can include sections on `coroutinedispatch` to showcase its benefits.
+The ``coroutinedispatch`` class should be documented in the Python standard library reference, with examples demonstrating its usage. Tutorials and guides on functional programming in Python can include sections on ``coroutinedispatch`` to showcase its benefits.
 
 Reference Implementation
 =========================
 
-A reference implementation of the `coroutinedispatch` class is provided below:
+A reference implementation of the ``coroutinedispatch`` class is provided below:
 
 .. code-block:: python