Skip to content

PD 9.0.0 manual revisions#21559

Open
emilyburghardt wants to merge 4 commits into
edgefrom
docs-pd-8.10.2
Open

PD 9.0.0 manual revisions#21559
emilyburghardt wants to merge 4 commits into
edgefrom
docs-pd-8.10.2

Conversation

@emilyburghardt
Copy link
Copy Markdown
Collaborator

@emilyburghardt emilyburghardt commented May 20, 2026

Overview

Adds a description of an improvement for PD 9.0.0/OT-2 PD 26.6.0.

previously: a user experiences a potential collision warning and might not know what's causing it.
now: a user experiences a potential collision warning; PD describes the slot the item(s) causing the risk/warning are located in and users can open the tip selection modal to see where tip pickups might be causing a warning.

DO NOT MERGE until PD 9.0.0 release, at which time I can merge this PR and complete a docs deploy from edge :)

Test Plan and Hands on Testing

sandbox

Changelog

See above.

Review requests

Risk assessment

low.

@emilyburghardt emilyburghardt changed the base branch from chore_release-pd-8.10.2 to docs-release-9.1.0 May 28, 2026 20:15
@codecov
Copy link
Copy Markdown

codecov Bot commented May 28, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 22.28%. Comparing base (4ee582e) to head (3acd9ce).
⚠️ Report is 27 commits behind head on edge.

Additional details and impacted files

Impacted file tree graph

@@            Coverage Diff             @@
##             edge   #21559      +/-   ##
==========================================
+ Coverage   21.69%   22.28%   +0.59%     
==========================================
  Files        3906     3907       +1     
  Lines      320209   320282      +73     
  Branches    57718    57709       -9     
==========================================
+ Hits        69465    71377    +1912     
+ Misses     247755   245910    -1845     
- Partials     2989     2995       +6     
Flag Coverage Δ
app 46.40% <ø> (+<0.01%) ⬆️
components 42.33% <ø> (-0.15%) ⬇️
protocol-designer 39.55% <ø> (ø)
react-api-client 21.17% <ø> (-0.06%) ⬇️
robot-server 83.43% <ø> (+15.51%) ⬆️
step-generation 60.71% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.
see 138 files with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@emilyburghardt emilyburghardt changed the base branch from docs-release-9.1.0 to chore_release-pd-8.10.2 May 28, 2026 20:58
@emilyburghardt emilyburghardt changed the base branch from chore_release-pd-8.10.2 to docs-release-9.1.0 May 28, 2026 20:59
@ecormany ecormany changed the base branch from docs-release-9.1.0 to edge June 1, 2026 18:27
@ecormany ecormany added the DO NOT MERGE Indicates a PR should not be merged, even if there's a shiny green merge button available label Jun 1, 2026
@emilyburghardt emilyburghardt marked this pull request as ready for review June 3, 2026 23:15
Copy link
Copy Markdown
Contributor

@jwwojak jwwojak left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not a PD expert by any means, but a few thoughts for review.

</figure>

Even though the tip rack above is full of pipette tips, the "not enough tips" warning tells you that there aren't enough tips that the pipette can safely access. This results in a collision error to prevent the pipette from striking adjacent labware in your final protocol.
Even though the tip rack above is full of pipette tips, the "not enough tips" warning tells you that there aren't enough tips that the pipette can safely access to complete your protocol step. This results in a collision error to prevent the pipette from striking adjacent labware in your final protocol.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This really is fine as is, just a suggestion for consideration to reduce some words and sharpen the edge a bit:

Suggested change
Even though the tip rack above is full of pipette tips, the "not enough tips" warning tells you that there aren't enough tips that the pipette can safely access to complete your protocol step. This results in a collision error to prevent the pipette from striking adjacent labware in your final protocol.
Even though the tip rack above is full, the "not enough tips" warning indicates that the pipette cannot safely access them to complete the step. The software triggers a collision error to prevent the pipette from striking adjacent labware during your protocol run.

You could also say, "The robot triggers a collions error.." or "The Flex trigges a collision error..." too.

¯_(ツ)_/¯

Even though the tip rack above is full of pipette tips, the "not enough tips" warning tells you that there aren't enough tips that the pipette can safely access to complete your protocol step. This results in a collision error to prevent the pipette from striking adjacent labware in your final protocol.

To fix the collision error, move the tip racks so they are no longer adjacent, or change your tip pickup selections.
To fix the collision error in the example above, move the well plate from slot C3 so the labware items are no longer adjacent, or change your tip pickup selections.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could change "fix" to "resolve" but that's also used on line 181 below, so repetition?

Consider trying an "either...or" for this sentence as a signal to the reader that there are some options coming:

To fix the collision error in the example above, either move the well plate from slot C3 so the labware items are no longer adjacent, or change your tip pickup selections.

Could do bullets here too!

To fix the collision error in this example, you can either:

  • Move the well plate...
  • Change your tip pickup selections

With bullets, you get some nice punchy imperative verbs (do this! do that!).


Fix all errors before exporting to ensure your protocol runs successfully. You won't be able to run protocols with unresolved errors.

To make it easier to resolve tip pickup warnings, be sure **Manual tip tracking** is selected, then click to select tips for manual pickup. This form can show you which selection is causing the collision error, and which tip pickups could work for your step.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bullets might work here as well.

To resolve tip pickup warnings more easily:

  • Select Manual tip tracking
  • Click to select tips for manual pickup

This form can show you which section...

@emilyburghardt emilyburghardt changed the title PD 8.10.2 manual revisions PD 9.0.0 manual revisions Jun 4, 2026
@ecormany ecormany removed the DO NOT MERGE Indicates a PR should not be merged, even if there's a shiny green merge button available label Jun 4, 2026
Copy link
Copy Markdown
Contributor

@ecormany ecormany left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Joe's comments look good. Addressing them would be enough to merge.

Can of worms question: The "Transfer steps" page is now well over 2000 words plus screenshots. Should we consider breaking it into 4 pages (for each of its H2 sections)?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants