docs(html): improve API docs

[kt3k]

part of #4600 #3764

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 92.36%. Comparing base (fc3d376) to head (07b1339).
Report is 2 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #4878   +/-   ##
=======================================
  Coverage   92.36%   92.36%           
=======================================
  Files         488      488           
  Lines       41603    41603           
  Branches     5407     5407           
=======================================
  Hits        38425    38425           
  Misses       3122     3122           
  Partials       56       56           

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