[documentation]: Improve documentation for more readability and maintenance by other devs

[vanilla-extracts]

Implements #87

[codecov-commenter]

⚠️ Please install the to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

❌ Patch coverage is 0.95238% with 104 lines in your changes missing coverage. Please review.
✅ Project coverage is 11.11%. Comparing base (3696ca4) to head (fde9202).

Files with missing lines	Patch %	Lines
src/main.rs	0.00%	104 Missing ⚠️
❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files

@@             Coverage Diff              @@
##           mistress      #86      +/-   ##
============================================
- Coverage     11.13%   11.11%   -0.02%     
============================================
  Files            23       23              
  Lines          4652     4677      +25     
============================================
+ Hits            518      520       +2     
- Misses         4134     4157      +23     

☔ 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.