docs: reformat the documentation #1297

Job	Run time
Doc style	17s
Code style	53s
Update CHANGELOG (on release)	0s
Doc building	2m 4s
Build and smoke tests (ubuntu-latest, 3.9, false)	26s
Build and smoke tests (ubuntu-latest, 3.10, false)	39s
Build and smoke tests (ubuntu-latest, 3.11, false)	24s
Build and smoke tests (ubuntu-latest, 3.12, false)	21s
Build and smoke tests (windows-latest, 3.9, false)	1m 23s
Build and smoke tests (windows-latest, 3.10, false)	1m 59s
Build and smoke tests (windows-latest, 3.11, false)	1m 30s
Build and smoke tests (windows-latest, 3.12, false)	1m 43s
Build library	16s
Release project to private PyPI, public PyPI and GitHub	0s
Doc dev version deploy	0s
Doc stable version deploy	0s
Deploy dev index docs	0s
Deploy stable docs index	0s
	11m 55s

Provide feedback