Revise documentation

[gilch]

#248 and #245 made pretty deep changes without thorough documentation corrections.

I need to read through the docs again and make sure everything still makes sense.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (9f40b23) 98.76% compared to head (1e56fea) 98.89%.

❗ Current head 1e56fea differs from pull request most recent head a22cb56. Consider uploading reports for the commit a22cb56 to get more accurate results

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #249      +/-   ##
==========================================
+ Coverage   98.76%   98.89%   +0.13%     
==========================================
  Files           6        6              
  Lines         726      726              
  Branches      112      112              
==========================================
+ Hits          717      718       +1     
+ Misses          5        4       -1     
  Partials        4        4              

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