docs(api): runtime parameters in Python API 2.18

[ecormany]

Overview

Full documentation for setting up and using runtime parameters in Python protocols.

Closes RTC-416, RTC-428, RTC-429, RTC-430, RTC-451

Test Plan

• Check content and formatting of all pages in the sandbox
• Simulate all code from use case pages.

Changelog

• New landing page for Runtime Parameters
• 6 new subpages
• Unhide ProtocolContext.params in API Reference. Note, this still needs a docstring, either here or in a separate PR. Added docstring.

Review requests

Read some or all of it, try the code, tell me what can be better.

Risk assessment

None

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

❗ No coverage uploaded for pull request base (docs_release-2.18@a55d47a). Click here to learn what that means.

❗ Current head 3d5e701 differs from pull request most recent head 3b8926b. Consider uploading reports for the commit 3b8926b to get more accurate results

Additional details and impacted files

@@                 Coverage Diff                  @@
##             docs_release-2.18   #14677   +/-   ##
====================================================
  Coverage                     ?   67.20%           
====================================================
  Files                        ?     2495           
  Lines                        ?    71406           
  Branches                     ?     8992           
====================================================
  Hits                         ?    47985           
  Misses                       ?    21305           
  Partials                     ?     2116           

Flag	Coverage Δ
g-code-testing	92.43% <ø> (?)

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

Files	Coverage Δ
...i/src/opentrons/protocol_api/instrument_context.py	89.09% <ø> (ø)

[jwwojak]

Awesome additions to the API docs. I did leave some comments. Please take a look.

[sanni-t]

This is awesome!
Still going through the PR, just minor corrections so far.

[sanni-t]

Just the above comments from me. Everything else looks great!
Doesn't have to be in this PR but I'm wondering if it would be useful to have screenshots of the app flow to help understand the significance of all the parameters' arguments (display name/ description/ choices, etc).

[ecormany]

Just the above comments from me. Everything else looks great! Doesn't have to be in this PR but I'm wondering if it would be useful to have screenshots of the app flow to help understand the significance of all the parameters' arguments (display name/ description/ choices, etc).

Thanks for the comments!

I've deliberately kept the UI out of the Python docs (here and elsewhere). Although I hope that we'll have a video or some other visual resource that I can link to from one of these pages, either in time for release or shortly after.