docs: Complete parameters description and add an example for clip()

[etiennebacher]

Fixes #18345

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 79.43%. Comparing base (03ba07a) to head (1b9b2b0).
Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #19875      +/-   ##
==========================================
- Coverage   79.44%   79.43%   -0.01%     
==========================================
  Files        1550     1550              
  Lines      215192   215192              
  Branches     2447     2447              
==========================================
- Hits       170952   170943       -9     
- Misses      43683    43692       +9     
  Partials      557      557              

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

---

🚨 Try these New Features:

• Flaky Tests Detection - Detect and resolve failed and flaky tests