docs: reformat the documentation #1256

Job	Run time
Code style	1m 3s
Doc style	13s
Update CHANGELOG (on release)	0s
Doc building	1m 38s
Build and smoke tests (ubuntu-latest, 3.9, false)	29s
Build and smoke tests (ubuntu-latest, 3.10, false)	21s
Build and smoke tests (ubuntu-latest, 3.11, false)	27s
Build and smoke tests (ubuntu-latest, 3.12, false)	28s
Build and smoke tests (windows-latest, 3.9, false)	1m 51s
Build and smoke tests (windows-latest, 3.10, false)	1m 36s
Build and smoke tests (windows-latest, 3.11, false)	1m 46s
Build and smoke tests (windows-latest, 3.12, false)	1m 47s
Build library	1s
Doc dev version deploy	1s
Release project to private PyPI, public PyPI and GitHub	1s
Deploy dev index docs	1s
Doc stable version deploy	1s
Deploy stable docs index	1s
	11m 45s

Provide feedback