docs: fix docstrings across public API surface (#2095) #811

Job	Run time
checks / pre-commit	35s
checks / readme-snippets	10s
checks / test (3.10, locked, ubuntu-latest)	52s
checks / test (3.11, lowest-direct, windows-latest)	2m 41s
checks / test (3.10, lowest-direct, ubuntu-latest)	58s
checks / test (3.11, locked, windows-latest)	2m 37s
checks / test (3.11, lowest-direct, ubuntu-latest)	54s
checks / test (3.11, locked, ubuntu-latest)	45s
checks / test (3.12, lowest-direct, ubuntu-latest)	54s
checks / test (3.10, locked, windows-latest)	2m 9s
checks / test (3.13, locked, windows-latest)	2m 35s
checks / test (3.14, lowest-direct, windows-latest)	2m 30s
checks / test (3.13, lowest-direct, ubuntu-latest)	55s
checks / test (3.12, locked, ubuntu-latest)	54s
checks / test (3.10, lowest-direct, windows-latest)	2m 31s
checks / test (3.14, locked, windows-latest)	3m 1s
checks / test (3.13, lowest-direct, windows-latest)	3m 11s
checks / test (3.14, lowest-direct, ubuntu-latest)	1m 19s
checks / test (3.13, locked, ubuntu-latest)	47s
checks / test (3.14, locked, ubuntu-latest)	2m 22s
checks / test (3.12, lowest-direct, windows-latest)	3m 37s
checks / test (3.12, locked, windows-latest)	3m 35s
all-green	2s
	39m 54s

Provide feedback