docs: touchscreen-settings-available-features

[jwwojak]

Overview

Updates the Flex manual chapter Touchscreen > Robot Settings. This lists and describes the currently available features on that part of the touchscreen.

Sandbox: https://sandbox.docs.opentrons.com/docs-touchscreen-settings-revisions/flex/touchscreen/settings/

RTC-896

Maybe for January.

Test Plan and Hands on Testing

Check images and links.

Changelog

This PR introduces some changes to the existing doc to take advantage of MkDocs features (e.g. tables of contents) that weren't available when this was first created.

• Revised intro paragraph

• Changed image to fade out and show fewer options from the settings screen. Why? Gets us out of the business of maintaining an image when features change. Just update text and show only enough of an image so readers recognize/know where they are on the touchscreen. Text changes are easier than image updates.

• Keeps the topical section organization but now uses H2 and H3 headers to show all the settings on the page-level TOC.

  • H2 headers are categories
  • H3 headers are individual settings

In the current version, the TOC is somewhat opaque with category headers only. With H3s we can now list and show all the settings, which also eliminates the need for a full image at the beginning.

Review requests

• Still unsure about one particular setting: Disabling some Stacker x y axis detection. Checking on it. A WTF item.
• Does the new organization/structure work. I think it does but is there an even better way to move things around?

Risk assessment

• Low, docs only.

[jwwojak]

And also, @vegano1 See settings.md , line 70. Stacker sensor feature description.

[emilyburghardt]

general comments to open a discussion!

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 56.76%. Comparing base (c4b3936) to head (12ea191).
⚠️ Report is 1 commits behind head on edge.

Additional details and impacted files

@@            Coverage Diff             @@
##             edge   #20424      +/-   ##
==========================================
- Coverage   56.76%   56.76%   -0.01%     
==========================================
  Files        3911     3911              
  Lines      322702   322702              
  Branches    45747    45747              
==========================================
- Hits       183186   183177       -9     
- Misses     139299   139308       +9     
  Partials      217      217              

Flag	Coverage Δ
app	46.06% <ø> (-0.01%)	⬇️
step-generation	5.72% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.
see 2 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.