docs: improve README.md

[ThirdEyeSqueegee]

Issue #, if available:

Description of changes:
Pending formatting changes (Prettier), will run the formatter and update the PR after the content changes are approved.

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 60.10%. Comparing base (8ee3efc) to head (7262a01).
⚠️ Report is 36 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #535   +/-   ##
=======================================
  Coverage   60.10%   60.10%           
=======================================
  Files          11       11           
  Lines         762      762           
=======================================
  Hits          458      458           
  Misses        287      287           
  Partials       17       17           

☔ View full report in Codecov by Harness.
📢 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.