python/ Improve docs. #830

Job	Run time
Test macos-15-intel (3.10)	1m 36s
Test ubuntu-latest (3.12)	1m 59s
Test ubuntu-latest (3.11)	1m 13s
build_sdist (3.10, ubuntu-latest)	21s
Build documentation	2m 14s
Coverage ubuntu-latest (3.10)	54s
🎡 Build wheels on windows-2025 (3.10)	5m 15s
🎡 Build wheels on macos-14 (3.10)	7m 49s
🎡 Build wheels on ubuntu-22.04-arm (3.10)	8m 25s
🎡 Build wheels on windows-11-arm (3.11)	8m 26s
🎡 Build wheels on ubuntu-22.04 (3.10)	6m 16s
Store wheels	5s
Publish Python 🐍 distribution 📦 to PyPI	0s
	44m 33s

Provide feedback