From f5ccda4efa6cca45df69ab2e6b19c72d3e0d7d21 Mon Sep 17 00:00:00 2001 From: Edward Cormany Date: Fri, 25 Apr 2025 09:46:16 -0400 Subject: [PATCH] deprecate combination adapters --- api/docs/v2/new_labware.rst | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/api/docs/v2/new_labware.rst b/api/docs/v2/new_labware.rst index 0ede3a9573b6..66de028637b0 100644 --- a/api/docs/v2/new_labware.rst +++ b/api/docs/v2/new_labware.rst @@ -156,13 +156,17 @@ Use the ``adapter`` argument of ``load_labware()`` to load an adapter at the sam .. versionadded:: 2.15 The ``adapter`` parameter. -The API also has some "combination" labware definitions, which treat the adapter and labware as a unit:: +.. note:: - hs_combo = hs_mod.load_labware( - "opentrons_96_flat_bottom_adapter_nest_wellplate_200ul_flat" - ) + The API also has some "combination" labware definitions, which treat the adapter and labware as a unit:: + + hs_combo = hs_mod.load_labware( + "opentrons_96_flat_bottom_adapter_nest_wellplate_200ul_flat" + ) + + .. deprecated:: 2.15 -Loading labware this way prevents you from :ref:`moving the labware ` onto or off of the adapter, so it's less flexible than loading the two separately. Avoid using combination definitions unless your protocol specifies an ``apiLevel`` of 2.14 or lower. + Labware loaded with combination adapters no longer support all API features, such as moving the top labware or pipetting relative to liquid meniscus. These definitions are marked as "Retired" in version 8.5.0 of the Opentrons App and later. Avoid using combination definitions unless your protocol specifies an ``apiLevel`` of 2.14 or lower, in which case they are required. .. _new-well-access: