docs: reformat the documentation #1252

Job	Run time
Code style	57s
Doc style	16s
Update CHANGELOG (on release)	0s
Doc building	1m 29s
Build and smoke tests (ubuntu-latest, 3.9, false)	35s
Build and smoke tests (ubuntu-latest, 3.10, false)	30s
Build and smoke tests (ubuntu-latest, 3.11, false)	21s
Build and smoke tests (ubuntu-latest, 3.12, false)	25s
Build and smoke tests (windows-latest, 3.9, false)	1m 58s
Build and smoke tests (windows-latest, 3.10, false)	2m 10s
Build and smoke tests (windows-latest, 3.11, false)	1m 14s
Build and smoke tests (windows-latest, 3.12, false)	1m 52s
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
	12m 3s

Provide feedback