improve docs #1513

Job	Run time
doctest-lxml (3.12)	10s
cpython (3.8)	1m 0s
cpython-lxml (3.8)	1m 27s
pypy (pypy-3.8)	1m 7s
cpython (3.9)	52s
cpython-lxml (3.9)	1m 18s
pypy (pypy-3.9)	52s
cpython (3.10)	53s
cpython-lxml (3.10)	1m 16s
pypy (pypy-3.10)	57s
static-tests (3.12)	26s
cpython (3.11)	57s
cpython-lxml (3.11)	1m 41s
cpython (3.12)	55s
cpython-lxml (3.12)	1m 56s
cpython (3.13)	1m 8s
cpython-lxml (3.13)	2m 8s
cpython (3.14-dev)	1m 7s
Build and publish to PyPI and TestPyPI	1s
	20m 11s

Provide feedback