Spruce up docs for pydoclint rules #38457

Job	Run time
cargo build (release)	0s
Determine changes	9s
mkdocs	2m 26s
cargo fmt	19s
pre-commit	3m 17s
python package	1m 18s
cargo clippy	2m 9s
cargo fuzz build	5m 11s
benchmarks	5m 54s
cargo build (msrv)	4m 12s
cargo shear	29s
cargo test (linux)	1m 46s
cargo test (linux, release)	3m 37s
cargo test (wasm)	1m 52s
cargo test (windows)	3m 1s
test scripts	1m 43s
formatter instabilities and black similarity	0s
test ruff-lsp	58s
ecosystem	2m 42s
fuzz parser	0s
	41m 3s

Provide feedback