Add a useful description to README file.

[jesper-friis]

Closes #18

If the mkdocs generated reference documentation is available somewhere, then a link should be added to it from the README file.

[codecov-commenter]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 71.02%. Comparing base (0f2ce17) to head (30956ef).

Additional details and impacted files

@@            Coverage Diff             @@
##             main      #19      +/-   ##
==========================================
+ Coverage   70.53%   71.02%   +0.49%     
==========================================
  Files           6        6              
  Lines         526      528       +2     
==========================================
+ Hits          371      375       +4     
+ Misses        155      153       -2     

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

[CasperWA]

Please update the README.md accordingly and subsequently run pre-commit run docs-landing-page to update the docs/index.md file.

mkdocstrings supports referencing specific Python API functions, classes, methods, etc. But the landing page/README is special, since it needs to support both GitHub and the documentation, so I'll try to ensure both renditions work, including the automatic referencing in the documentation build. (I have created issue #22 to follow up on this after this PR has been merged.)

[CasperWA]

This branch should have the latest changes from main merged into it as well, which updates the copyright information.

[jesper-friis]

Do I really have to mark all our disagreements as resolved in order to ask you for a new review?

[CasperWA]

Do I really have to mark all our disagreements as resolved in order to ask you for a new review?

I mentioned only those you haven't reacted to that includes suggested changes that does not focus on the style changes. Please address these suggested changes and comments, yes. Otherwise what's the point of doing a review if it's not taken serious?
Edit: If there are some suggested changes you will not implement, please say so and then "resolve" the specific conversation, or simply "resolve" it without implementing the change.

[jesper-friis]

Please address these suggested changes and comments, yes. Otherwise what's the point of doing a review if it's not taken serious? Edit: If there are some suggested changes you will not implement, please say so and then "resolve" the specific conversation, or simply "resolve" it without implementing the change.

I accepted most suggestions, except those changing the header style.