review feedback

ecormany · ecormany · commit d9839333c454 · 2025-08-08T14:46:03.000-04:00
diff --git a/docs/flex/docs/labware/concepts.md b/docs/flex/docs/labware/concepts.md
@@ -26,7 +26,7 @@ Let's take a moment to unpack the concept of custom labware.
 
 As an example, the Opentrons Labware Library includes 96-well plates (200 µL) from Corning and Bio-Rad, but other manufacturers make these well plates too. And, thanks to commonly accepted industry standards, the differences among these ubiquitous lab items are minor. However, an ordinary 200 μL, 96-well plate from Stellar Scientific, Oxford Lab, or Krackeler Scientific (or any other supplier for that matter) is "custom labware" for the Flex because it isn't pre-defined in our Labware Library. Additionally, minor differences in labware dimensions can have a drastic impact on the success of your protocol run. For this reason, it's important to have an accurate labware definition for each labware you want to use in your protocol. 
 
-Also, while custom labware could be an esoteric, one-off piece of kit, most of the time it's just the tips, plates, tubes, and racks used every day in labs all over the world. Again, the only difference between Opentrons labware and custom labware is that the custom labware is not predefined in the software that powers the robot. The Flex can, and does, work with other basic labware items or something unique, but you need to record that item's characteristics in a labware definition JSON file and import that data into the Opentrons App. See the [Custom Labware Definitions section][custom-labware-definitions] below for more information. 
+Also, while custom labware could be an esoteric, one-off piece of kit, most of the time it's just the tips, plates, tubes, and racks used every day in labs all over the world. Again, the only difference between Opentrons labware and custom labware is that the custom labware is not predefined in the software that powers the robot. The Flex can, and does, work with other basic labware items or something unique, but you need to record that item's characteristics in a labware definition JSON file and import that data into the Opentrons App. See the [Labware Definitions section][labware-definitions] below for more information. 
 
 To sum up, labware includes:
 
diff --git a/docs/flex/docs/labware/gripper.md b/docs/flex/docs/labware/gripper.md
@@ -13,4 +13,4 @@ Although Opentrons Flex works with all items in the Labware Library, the Opentro
 - The NEST 1 Well Reservoir 195 mL.
 
 !!! note
-    For best results, use the Flex Gripper only with the labware listed above. If you need to use the gripper with other ANSI/SLAS automation compliant labware, you need to create a custom labware definition by manually editing the JSON file to include gripper-specific information. See the [Custom Labware Definitions section][custom-labware-definitions] or contact Opentrons Support for more information. 
+    For best results, use the Flex Gripper only with the labware listed above. If you need to use the gripper with other ANSI/SLAS automation compliant labware, you need to create a custom labware definition by manually editing the JSON file to include gripper-specific information. See the [Labware Definitions section][labware-definitions] or contact Opentrons Support for more information. 
diff --git a/docs/flex/docs/labware/types.md b/docs/flex/docs/labware/types.md
@@ -17,7 +17,7 @@ Opentrons Flex works by default with single-well and multi-well reservoirs. [Res
 
 Labware Library currently only includes reservoirs in 1-well and 12-well configurations, although other well configurations are possible.
 
-Try creating a custom labware definition with the [Opentrons Labware Creator](https://labware.opentrons.com/create/) if a reservoir you'd like to use isn't listed in the Labware Library. A custom definition combines all the dimensions, metadata, shapes, volumetric capacity, and other information in a JSON file. The Opentrons Flex needs this information to understand how to work with your custom labware. See the [Custom Labware Definitions section][custom-labware-definitions] for more information. 
+Try creating a custom labware definition with the [Opentrons Labware Creator](https://labware.opentrons.com/create/) if a reservoir you'd like to use isn't listed in the Labware Library. A custom definition combines all the dimensions, metadata, shapes, volumetric capacity, and other information in a JSON file. The Opentrons Flex needs this information to understand how to work with your custom labware. See the [Labware Definitions section][labware-definitions] for more information. 
 
 ## Well plates 
 
@@ -45,7 +45,7 @@ The Labware Library includes 384-well plates for applications that require great
 
 ### Custom well plates
 
-Try using the Opentrons Labware Creator to make a custom labware definition if a well plate you'd like to use isn't listed in the Labware Library. A custom definition combines all the dimensions, metadata, shapes, volumetric capacity, and other information in a JSON file. The Opentrons Flex reads this information to understand how to work with your custom labware. See the [Custom Labware Definitions section][custom-labware-definitions] for more information. 
+Try using the Opentrons Labware Creator to make a custom labware definition if a well plate you'd like to use isn't listed in the Labware Library. A custom definition combines all the dimensions, metadata, shapes, volumetric capacity, and other information in a JSON file. The Opentrons Flex reads this information to understand how to work with your custom labware. See the [Labware Definitions section][labware-definitions] for more information. 
 
 ## Lids
 
@@ -123,7 +123,7 @@ The 24-tube rack supports both snap cap and screw cap tubes.
 
 ### Custom tube rack labware 
 
-Try creating a custom labware definition using the [Opentrons Labware Creator](https://labware.opentrons.com/create/) if a tube and rack combination you'd like to use isn't listed on Labware Library. A custom definition combines all the dimensions, metadata, shapes, volumetric capacity, and other information in a JSON file. The Opentrons Flex reads this information to understand how to work with your custom labware. See the [Custom Labware Definitions section][custom-labware-definitions] for more information. 
+Try creating a custom labware definition using the [Opentrons Labware Creator](https://labware.opentrons.com/create/) if a tube and rack combination you'd like to use isn't listed on Labware Library. A custom definition combines all the dimensions, metadata, shapes, volumetric capacity, and other information in a JSON file. The Opentrons Flex reads this information to understand how to work with your custom labware. See the [Labware Definitions section][labware-definitions] for more information. 
 
 ## Aluminum blocks 
 
@@ -166,4 +166,4 @@ The 96-well block supports a wide variety of well plate types. For example, it a
 
 ### Custom aluminum block combinations
 
-Labware Creator can't define new aluminum blocks. For placing tubes in the 24-well block, it can create combination labware definitions that comprise the aluminum block and the tubes. For placing custom plates on the 96-well adapter, define the custom plate with the stacking offset information required for seating the plate on top of the block. See the [Custom Labware Definitions section][custom-labware-definitions] for more information.  
+Labware Creator can't define new aluminum blocks. For placing tubes in the 24-well block, it can create combination labware definitions that comprise the aluminum block and the tubes. For placing custom plates on the 96-well adapter, define the custom plate with the stacking offset information required for seating the plate on top of the block. See the [Labware Definitions section][labware-definitions] for more information.  
diff --git a/docs/flex/docs/opentrons-app.md b/docs/flex/docs/opentrons-app.md
@@ -73,11 +73,11 @@ Click the three-dot menu (⋮) on your protocol and choose **Start setup**. Choo
 
 If you stay in the app, expand the sections under the Setup tab and follow the instructions in each one: Robot Calibration, Module Setup (if your protocol uses modules), Labware Position Check (recommended), and Labware Setup. Then click :material-play-circle: **Start run** to to begin the protocol.
 
-If you move to the touchscreen, follow the steps in the [Run Setup section][run-setup] above.
+If you move to the touchscreen, follow the steps in the [Protocol Setup section][protocol-setup].
 
 ### Run later
 
-Click the three-dot menu (⋮) on your protocol and choose **Send to Opentrons Flex**. Choose a connected and available Flex from the list to transfer the protocol. A message indicating a successful transfer will pop up both in the app and on the touchscreen. To set up your protocol, you need to move to the touchscreen and follow the steps in the [Run Setup section][run-setup] above.
+Click the three-dot menu (⋮) on your protocol and choose **Send to Opentrons Flex**. Choose a connected and available Flex from the list to transfer the protocol. A message indicating a successful transfer will pop up both in the app and on the touchscreen. To set up your protocol, you need to move to the touchscreen and follow the steps in the [Protocol Setup section][protocol-setup].
 
 ## Module status and controls
 
diff --git a/docs/flex/docs/protocols/designer.md b/docs/flex/docs/protocols/designer.md
@@ -57,7 +57,7 @@ After naming your protocol, review the details in the protocol overview. Protoco
 
 ## Part 2: Edit a protocol
 
-Click **Edit protocol** to add labware, liquids, and additional hardware to your protocol. The protocol starting deck view shows everything on the deck down to individual wells -- even on 384-well plates. 
+Click **Edit protocol** to add labware, liquids, and additional hardware to your protocol. The protocol starting deck view shows everything on the deck down to individual wells, even on 384-well plates. 
 
 You can fully customize the Flex deck in Protocol Designer by adding compatible modules, staging areas, the waste chute, and custom labware. Click any open slot to add or edit hardware or labware. Click, drag, and drop to move labware and tips racks on the deck. 
 
diff --git a/docs/flex/docs/system-description/pipettes.md b/docs/flex/docs/system-description/pipettes.md
@@ -18,8 +18,10 @@ Opentrons *pipettes* are configurable devices used to move liquids throughout th
 
 Pipettes attach to the gantry using captive screws on the front of the pipette. 1-channel and 8-channel pipettes each occupy one *pipette mount* (left or right); the 96-channel pipette occupies both mounts. For details on installing pipettes, see [Instrument Installation and Calibration][instrument-installation-and-calibration].
 
+<figure markdown>
 ![Each capacity of pipette has captive attachment screws on its front. Pipette ejectors are at the bottom of each pipette, above the nozzles. The 1- and 8-channel pipettes have replaceable O-rings, and the 96-channel pipette has fixed O-rings.](../images/pipette-components.png "Pipette components")
-Locations of components of the 1-, 8-, and 96-channel pipettes.
+<figcaption>Locations of components of the 1-, 8-, and 96-channel pipettes.</figcaption>
+</figure>
 
 The pipettes pick up disposable plastic *tips* by pressing them onto the pipette *nozzles*, and then use the tips to aspirate and dispense liquids. The amount of total force required for pickup increases as more tips get picked up simultaneously. For smaller numbers of tips, the pipette attaches tips by pushing each pipette nozzle down into a tip. To achieve the necessary force to pick up a full rack of tips, the 96-channel pipette also pulls the tips upward onto the nozzles. This pulling action requires placing tip racks into a *tip rack adapter*, rather than directly in a deck slot. To discard tips (or return them to their rack), the pipette *ejector* mechanism pushes the tips off of the nozzles.
 
