Development branch for v2.1.1

[chrisroadmap]

To release once there is a critical need

Please confirm that this pull request has done the following:

• Tests added
• Documentation added (where applicable)
• Example added (either to an existing notebook or as a new notebook, where applicable)
• Description in CHANGELOG.rst added
• go back to github markdown for README #115
• Update to Docs and README #116
• Continuous integration #117
• Calibrated example requires external file #129
• xarray 2023.9.0 breaks fair #130

[codecov]

Codecov Report

All modified lines are covered by tests ✅

Comparison is base (4528252) 94.94% compared to head (39ba167) 95.08%.

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #118      +/-   ##
==========================================
+ Coverage   94.94%   95.08%   +0.13%     
==========================================
  Files          19       19              
  Lines         732      732              
  Branches      105      105              
==========================================
+ Hits          695      696       +1     
  Misses         16       16              
+ Partials       21       20       -1     

Files	Coverage Δ
src/fair/fair.py	91.34% <ø> (+0.24%)	⬆️

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