Add documentation of the design and intent of the record/replay mechanism.

[peterallenwebb]

No description provided.

[github-actions]

Thank you for your pull request! We could not find a changelog entry for this change. For details on how to document a change, see the contributing guide.

[codecov-commenter]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 56.29%. Comparing base (039edf2) to head (a941188).

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #129   +/-   ##
=======================================
  Coverage   56.29%   56.29%           
=======================================
  Files          50       50           
  Lines        3082     3082           
=======================================
  Hits         1735     1735           
  Misses       1347     1347           

Flag	Coverage Δ
unit	56.29% <ø> (ø)

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.

[emmyoop]

Mostly spell check. One request to add a comment about the current state being experimental. Otherwise this is great! Nice details.