diff --git a/api/docs/v2/index.rst b/api/docs/v2/index.rst
index 743bf425c91..376d483f33b 100644
--- a/api/docs/v2/index.rst
+++ b/api/docs/v2/index.rst
@@ -75,13 +75,13 @@ For example, if we wanted to transfer liquid from well A1 to well B1 on a plate,
             # protocol run function
             def run(protocol: protocol_api.ProtocolContext):
                 # labware
-		trash = protocol.load_trash_bin("A3")
                 plate = protocol.load_labware(
                     "corning_96_wellplate_360ul_flat", location="D1"
                 )
                 tiprack = protocol.load_labware(
                     "opentrons_flex_96_tiprack_200ul", location="D2"
                 )
+                trash = protocol.load_trash_bin(location="A3")
             
                 # pipettes
                 left_pipette = protocol.load_instrument(
diff --git a/api/docs/v2/new_examples.rst b/api/docs/v2/new_examples.rst
index 3d1fd4b35f4..85b4f75ea41 100644
--- a/api/docs/v2/new_examples.rst
+++ b/api/docs/v2/new_examples.rst
@@ -92,7 +92,7 @@ This code only loads the instruments and labware listed above, and performs no o
                     load_name="usascientific_12_reservoir_22ml", location="D1"
                 )
                 # load trash bin in deck slot A3
-                trash = protocol.load_trash_bin("A3")
+                trash = protocol.load_trash_bin(location="A3")
                 # Put protocol commands here
     
     .. tab:: OT-2 
diff --git a/api/docs/v2/versioning.rst b/api/docs/v2/versioning.rst
index 5d8e4cd3b82..08de1823cc4 100644
--- a/api/docs/v2/versioning.rst
+++ b/api/docs/v2/versioning.rst
@@ -126,11 +126,6 @@ This table lists the correspondence between Protocol API versions and robot soft
 Changes in API Versions
 =======================
 
-Version 2.17
-------------
-
-- :py:meth:`.dispense` will now raise an error if you try to dispense more than is available.
-
 Version 2.16
 ------------
 
diff --git a/api/src/opentrons/protocol_api/instrument_context.py b/api/src/opentrons/protocol_api/instrument_context.py
index 4403f8e5912..45b7d385684 100644
--- a/api/src/opentrons/protocol_api/instrument_context.py
+++ b/api/src/opentrons/protocol_api/instrument_context.py
@@ -345,10 +345,6 @@ def dispense(  # noqa: C901
 
         .. versionchanged:: 2.15
             Added the ``push_out`` parameter.
-
-        .. versionchanged:: 2.17
-            Now raises an exception if you try to dispense more than is available.
-            Previously, it would silently clamp.
         """
         if self.api_version < APIVersion(2, 15) and push_out:
             raise APIVersionError(