fixing a few docs issues

[jogomojo]

When pulling in recent PRs I overwrite a few docs changes by @mariodruiz and @exludai. Now fixed.

[codecov-commenter]

⚠️ Please install the to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 34.98%. Comparing base (0cacce3) to head (604de5d).

❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files

@@             Coverage Diff             @@
##           image_v3.1    #1485   +/-   ##
===========================================
  Coverage       34.98%   34.98%           
===========================================
  Files              30       30           
  Lines            4668     4668           
  Branches          818      818           
===========================================
  Hits             1633     1633           
  Misses           2975     2975           
  Partials           60       60           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.