docs: reformat the documentation #1300

Job	Run time
Code style	51s
Doc style	17s
Update CHANGELOG (on release)	0s
Doc building	1m 57s
Build and smoke tests (ubuntu-latest, 3.9, false)	25s
Build and smoke tests (ubuntu-latest, 3.10, false)	25s
Build and smoke tests (ubuntu-latest, 3.11, false)	28s
Build and smoke tests (ubuntu-latest, 3.12, false)	21s
Build and smoke tests (windows-latest, 3.9, false)	1m 39s
Build and smoke tests (windows-latest, 3.10, false)	1m 49s
Build and smoke tests (windows-latest, 3.11, false)	1m 25s
Build and smoke tests (windows-latest, 3.12, false)	1m 51s
Build library	13s
Doc dev version deploy	0s
Release project to private PyPI, public PyPI and GitHub	0s
Deploy dev index docs	0s
Doc stable version deploy	0s
Deploy stable docs index	0s
	11m 41s

Provide feedback