Improve the documentation.

[tobiasraabe]

Closes #502.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (d846c5c) 96.50% compared to head (d2e020a) 96.11%.
Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #509      +/-   ##
==========================================
- Coverage   96.50%   96.11%   -0.40%     
==========================================
  Files         104      104              
  Lines        8917     8921       +4     
==========================================
- Hits         8605     8574      -31     
- Misses        312      347      +35     

Flag	Coverage Δ
end_to_end	81.93% <100.00%> (+<0.01%)	⬆️
integration	40.23% <27.27%> (-0.03%)	⬇️
unit	68.13% <77.27%> (-0.38%)	⬇️

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.