Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs(api): miscellaneous changes for version 2.16 #14265

Merged
merged 7 commits into from
Dec 22, 2023
Merged

Conversation

ecormany
Copy link
Contributor

@ecormany ecormany commented Dec 21, 2023

Overview

This PR ties up a bunch of loose ends around the Python API version 2.16 release.

There's no guarantee that this has caught everything, but it should be sufficient for the initial docs@2.16 deploy. Any further changes can be made in subsequent PRs and deployed separately.

Test Plan

Take a good look through the sandbox. This PR touches a bunch of pages.

Changelog

  • Opengraph tags for new Pipette subpages.
  • Renames configure.rst to partial_tip_pickup.rst — should have been done in the initial refactor.
  • Adds section on moving labware into the waste chute.
  • Adds section on specifying pipette trash containers.
  • Misc changes in several places that talk about trash container behavior.
  • Adds load_trash_bin() to Flex snippets that need it.
  • Brings OT-2 snippets up to 2.16 with |apiLevel| substitution — we don't need to hold these back anymore.

Review requests

👀👀👀

Risk assessment

no code risk. low-ish docs risk. nothing that can't be fixed later.

@ecormany ecormany requested a review from a team as a code owner December 21, 2023 23:26
Copy link

codecov bot commented Dec 21, 2023

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (8bee89b) 68.05% compared to head (18c08ba) 68.05%.
Report is 1 commits behind head on edge.

Additional details and impacted files

Impacted file tree graph

@@           Coverage Diff           @@
##             edge   #14265   +/-   ##
=======================================
  Coverage   68.05%   68.05%           
=======================================
  Files        2509     2509           
  Lines       71343    71343           
  Branches     9063     9063           
=======================================
  Hits        48556    48556           
  Misses      20684    20684           
  Partials     2103     2103           
Flag Coverage Δ
g-code-testing 96.44% <ø> (ø)
notify-server 89.13% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

@ecormany ecormany requested review from jwwojak and removed request for a team December 21, 2023 23:33
.. versionadded:: 2.0

.. note::
Returning tips isn't allowed when using :ref:`partial tip pickup <partial-tip-pickup>`. The API will raise an error.
Copy link
Contributor

Choose a reason for hiding this comment

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

Everything in this PR is great. This last note stood out to me. Please give it some consideration.

  • You can't return tips when using partial tip pickup. The API will raise an error.

  • The API will raise an error if you try to return tips using partial tip pickup.

Or make it more explicit:

  • The return_tip() method does not work with partial tip pickup. You can only use return_tip() when picking up a full set up tips. <-- last sentence is weak, but the idea is return_tip only works with a "default" type of pickup.

Copy link
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.

I think this is great! Only one comment about a note for return_tip.

🚀

@ecormany ecormany added docs papi-v2 Python API V2 labels Dec 22, 2023
@@ -34,7 +34,7 @@ You also need to specify ``'robotType': 'Flex'``. If you omit ``robotType`` in t
metadata = {
"protocolName": "My Protocol",
"description": "This protocol uses the OT-2",
"apiLevel": "2.14"
"apiLevel": "|apiLevel|"
Copy link
Member

Choose a reason for hiding this comment

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

Noice

@ecormany ecormany merged commit ecadc94 into edge Dec 22, 2023
33 checks passed
@ecormany ecormany deleted the docs-2.16-loose-ends branch December 22, 2023 14:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs papi-v2 Python API V2
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants