Fixes in docs and new data checks

[sstroemer]

Related to #643

Summary of changes in this pull request

• Small fixes (typos, ...) to docstrings
• Checks for valid values of flow_cap_* and storage_initial (d99bf94); note that I'm unsure if the check for flow_cap_min <= flow_cap_max is done correctly?

Reviewer checklist

• Test(s) added to cover contribution
• Documentation updated
• Changelog updated
• Coverage maintained or improved

[sstroemer]

Adjusted all files according to discussion.

[brynpickering]

Just a minor suggestion, otherwise good to go.

I'm thinking we could do something about parameter-level checks as part of solving #642 (defining parameters as part of the YAML math, then having a "data-check" key to add checks at a parameter-level).

[brynpickering]

@sstroemer please fix the test that is now failing! Plus, add your name to the AUTHORS file.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 95.97%. Comparing base (4fc6b84) to head (4b011e5).
Report is 26 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #644   +/-   ##
=======================================
  Coverage   95.97%   95.97%           
=======================================
  Files          26       26           
  Lines        3980     3980           
  Branches      836      767   -69     
=======================================
  Hits         3820     3820           
  Misses         70       70           
  Partials       90       90