Update docs and cleanup some chaos API

[martintmk]

Pull Request

The issue or feature being addressed

Contributes to #1901

Confirm the following

• I started this PR by branching from the head of the default branch
• I have targeted the PR to merge into the default branch
• I have included unit tests for the issue/feature
• I have successfully run a local build

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (54becab) 84.80% compared to head (90d4004) 84.80%.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #1914   +/-   ##
=======================================
  Coverage   84.80%   84.80%           
=======================================
  Files         312      312           
  Lines        6897     6897           
  Branches     1056     1056           
=======================================
  Hits         5849     5849           
  Misses        839      839           
  Partials      209      209           

Flag	Coverage Δ
linux	84.80% <100.00%> (ø)
macos	84.80% <100.00%> (?)
windows	?

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

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