DOC: API reference tweaks & clean-up #390

Job	Run time
ubuntu-latest, 3.10, ci/environment.yml	48s
ubuntu-latest, 3.10, ci/environment.yml	48s
ubuntu-latest, 3.11, ci/environment.yml	58s
ubuntu-latest, 3.11, ci/environment.yml	58s
ubuntu-latest, 3.12, ci/environment.yml	44s
ubuntu-latest, 3.12, ci/environment.yml	44s
macos-latest, 3.10, ci/environment.yml	1m 4s
macos-latest, 3.10, ci/environment.yml	1m 4s
macos-latest, 3.11, ci/environment.yml	50s
macos-latest, 3.11, ci/environment.yml	50s
macos-latest, 3.12, ci/environment.yml	49s
macos-latest, 3.12, ci/environment.yml	49s
windows-latest, 3.10, ci/environment.yml	2m 41s
windows-latest, 3.10, ci/environment.yml	2m 41s
windows-latest, 3.11, ci/environment.yml	3m 9s
windows-latest, 3.11, ci/environment.yml	3m 19s
windows-latest, 3.12, ci/environment.yml	3m 0s
windows-latest, 3.12, ci/environment.yml	3m 0s
ubuntu-latest, 3.12, ci/environment-dev.yml	1m 29s
ubuntu-latest, 3.12, ci/environment-dev.yml	1m 29s
macos-latest, 3.12, ci/environment-dev.yml	1m 16s
macos-latest, 3.12, ci/environment-dev.yml	1m 16s
windows-latest, 3.12, ci/environment-dev.yml	4m 27s
windows-latest, 3.12, ci/environment-dev.yml	4m 27s
	42m 40s

Provide feedback