Add API usage info to documentation

[mrbean-bremen]

Tasks

• For documentation changes: docs build succeeded and documentation looks as expected

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 89.20%. Comparing base (e8644e2) to head (7e7ef12).
⚠️ Report is 162 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #242      +/-   ##
==========================================
- Coverage   89.82%   89.20%   -0.63%     
==========================================
  Files          15       21       +6     
  Lines        1632     2139     +507     
==========================================
+ Hits         1466     1908     +442     
- Misses        166      231      +65     

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