docs: fix docstrings across public API surface #808

Job	Run time
checks / readme-snippets	13s
checks / pre-commit	35s
checks / test (3.11, locked, ubuntu-latest)	48s
checks / test (3.10, locked, ubuntu-latest)	51s
checks / test (3.10, lowest-direct, windows-latest)	2m 29s
checks / test (3.11, lowest-direct, windows-latest)	2m 37s
checks / test (3.10, locked, windows-latest)	2m 14s
checks / test (3.12, locked, windows-latest)	3m 15s
checks / test (3.11, locked, windows-latest)	2m 28s
checks / test (3.11, lowest-direct, ubuntu-latest)	56s
checks / test (3.13, lowest-direct, ubuntu-latest)	55s
checks / test (3.13, locked, windows-latest)	2m 24s
checks / test (3.12, locked, ubuntu-latest)	53s
checks / test (3.10, lowest-direct, ubuntu-latest)	51s
checks / test (3.13, locked, ubuntu-latest)	48s
checks / test (3.14, locked, ubuntu-latest)	2m 19s
checks / test (3.14, lowest-direct, windows-latest)	2m 56s
checks / test (3.12, lowest-direct, ubuntu-latest)	1m 1s
checks / test (3.12, lowest-direct, windows-latest)	3m 40s
checks / test (3.14, locked, windows-latest)	3m 9s
checks / test (3.13, lowest-direct, windows-latest)	2m 36s
checks / test (3.14, lowest-direct, ubuntu-latest)	1m 19s
all-green	2s
	39m 19s

Provide feedback