docs: switch README to markdown and update

[adbar]

Work in progress:

• There are still issues with formatting
• Docs requirements (choose which file, pin versions?)

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 96.36%. Comparing base (1eaeceb) to head (c4563fe).
Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #123      +/-   ##
==========================================
- Coverage   97.23%   96.36%   -0.87%     
==========================================
  Files          32       32              
  Lines         578      578              
==========================================
- Hits          562      557       -5     
- Misses         16       21       +5     

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