[docs] improve docstrings by adding examples

[odow]

Follow-up to #3758

[codecov[bot]]

Codecov Report

All modified and coverable lines are covered by tests :white_check_mark:

Project coverage is 98.38%. Comparing base (51ac43c) to head (8bc35ab).

Additional details and impacted files

```diff @@ Coverage Diff @@ ## master #3761 +/- ## ======================================= Coverage 98.38% 98.38% ======================================= Files 44 44 Lines 5872 5873 +1 ======================================= + Hits 5777 5778 +1 Misses 95 95 ```

:umbrella: View full report in Codecov by Sentry.
:loudspeaker: Have feedback on the report? Share it here.