add documentation details about usage limits

[gboeing]

Addresses #1377

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 98.61%. Comparing base (6bc7885) to head (5164902).
⚠️ Report is 6 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #1378   +/-   ##
=======================================
  Coverage   98.61%   98.61%           
=======================================
  Files          25       25           
  Lines        2594     2594           
=======================================
  Hits         2558     2558           
  Misses         36       36           

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