From 7843b3a62c1d6c4296ab74cc7fe31273bc88d1bb Mon Sep 17 00:00:00 2001
From: blaisep <blaise@gmail.com>
Date: Thu, 22 May 2025 11:25:07 -0400
Subject: [PATCH] Add example for `str.encode()`

WIP to fix #106318
---
 Doc/library/stdtypes.rst | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index 3486a18b5cb1f0..3c753dee679af7 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -1817,9 +1817,15 @@ expression support in the :mod:`re` module).
    See :ref:`error-handlers` for details.
 
    For performance reasons, the value of *errors* is not checked for validity
-   unless an encoding error actually occurs,
-   :ref:`devmode` is enabled
-   or a :ref:`debug build <debug-build>` is used.
+   unless an encoding error actually occurs, :ref:`devmode` is enabled or a :ref:`debug build <debug-build>` is used.
+   For example::
+
+      >>> encoded_str_to_byte = 'Python'.encode()
+      >>> type(encoded_str_to_byte)
+      <class 'bytes'>
+      >>> encoded_str_to_byte
+      b'Python'
+
 
    .. versionchanged:: 3.1
       Added support for keyword arguments.