Improve documentation

[pont-us]

Closes #22 .

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 80.52%. Comparing base (5a4c760) to head (4e0e3aa).
⚠️ Report is 8 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main      #53   +/-   ##
=======================================
  Coverage   80.52%   80.52%           
=======================================
  Files           6        6           
  Lines         529      529           
  Branches       62       62           
=======================================
  Hits          426      426           
  Misses         97       97           
  Partials        6        6           

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

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[pont-us]

Merging with less content than originally intended due to time pressure. Will create a follow-up issue to expand documentation later.