269 improve the documentation with examples #1514

Job	Run time
cpython (3.8)	56s
cpython-lxml (3.8)	1m 22s
cpython-lxml (3.9)	1m 30s
cpython (3.9)	55s
cpython-lxml (3.10)	1m 17s
cpython (3.10)	53s
cpython-lxml (3.11)	1m 26s
cpython (3.11)	52s
cpython-lxml (3.12)	2m 20s
cpython (3.12)	53s
cpython-lxml (3.13)	2m 29s
cpython (3.13)	1m 5s
cpython (3.14-dev)	1m 13s
doctest-lxml (3.12)	11s
static-tests (3.12)	27s
pypy (pypy-3.8)	1m 15s
pypy (pypy-3.9)	58s
pypy (pypy-3.10)	1m 5s
Build and publish to PyPI and TestPyPI	0s
	21m 7s

Provide feedback