MAINT: Remove ignore of deprecation warning

[j-t-1]

Also modify docstring.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 96.97%. Comparing base (b622a2f) to head (ed4044c).
⚠️ Report is 45 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #3428   +/-   ##
=======================================
  Coverage   96.97%   96.97%           
=======================================
  Files          54       54           
  Lines        9324     9324           
  Branches     1708     1708           
=======================================
  Hits         9042     9042           
  Misses        168      168           
  Partials      114      114           

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