feat: improve documentation of the scripts options #447

Job	Run time
Tests on other platforms (windows-2019, 3.10)	5m 40s
Tests on paywalled platforms	0s
Tests on other platforms (windows-2022, 3.11)	4m 12s
Tox test (py38)	3m 46s
Tox test (py39)	3m 54s
Tests on other platforms (windows-2022, 3.12)	3m 44s
Tox test (py310)	3m 46s
Tests on other platforms (macos-13, 3.12)	4m 44s
Tox test (py311)	3m 30s
Tests on other platforms (macos-14, 3.12)	1m 55s
Tox test (py312-cover)	6m 45s
Tox test (docs, graphviz)	1m 49s
PyPI packaging	0s
Docker image	0s
	43m 45s

Provide feedback