Merge branch '3.x-line' into dev

CHANGELOG.rst

@@ -133,7 +133,7 @@ Features:
 
 Documentation:
 
-- Various documentation improvements (:pr:`2757`, :pr:`2759`, :pr:`2765`, :pr:`2774`).
+- Various documentation improvements (:pr:`2757`, :pr:`2759`, :pr:`2765`, :pr:`2774`, :pr:`2778`).
 
 Deprecations:
 

docs/examples/index.rst

@@ -0,0 +1,16 @@
+********
+Examples
+********
+
+The below examples demonstrate how to use marshmallow in various contexts.
+To run each example, you will need to have `uv <https://docs.astral.sh/uv/getting-started/installation/>`_ installed.
+The examples use `PEP 723 inline metadata <https://peps.python.org/pep-0723/>`_
+to declare the dependencies of each script. ``uv`` will install the
+dependencies automatically when running these scripts.
+
+.. toctree::
+  :maxdepth: 1
+
+  validating_package_json
+  quotes_api
+  inflection

docs/examples/inflection.rst

@@ -0,0 +1,19 @@
+*****************************
+Inflection (camel-cased keys)
+*****************************
+
+HTTP APIs will often use camel-cased keys for their input and output representations. This example shows how you can use the
+`Schema.on_bind_field <marshmallow.Schema.on_bind_field>` hook to automatically inflect keys.
+
+.. literalinclude:: ../../examples/inflection_example.py
+    :language: python
+
+To run the example:
+
+.. code-block:: shell-session
+
+    $ uv run examples/inflection_example.py
+    Loaded data:
+    {'first_name': 'David', 'last_name': 'Bowie'}
+    Dumped data:
+    {'firstName': 'David', 'lastName': 'Bowie'}