Improve docs

[gdalle]

Documentation

• Clarify and restructure minor things

[codecov-commenter]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 95.01%. Comparing base (17cdd2a) to head (34873ec).
Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #234      +/-   ##
==========================================
- Coverage   96.27%   95.01%   -1.26%     
==========================================
  Files          74       15      -59     
  Lines        3924     1787    -2137     
==========================================
- Hits         3778     1698    -2080     
+ Misses        146       89      -57     

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