docs: restructure README into docs/ pages #4196

Job	Run time
checks / pre-commit	34s
checks / readme-snippets	12s
checks / test (3.10, lowest-direct, windows-latest)	2m 22s
checks / test (3.13, lowest-direct, windows-latest)	2m 15s
checks / test (3.11, highest, ubuntu-latest)	45s
checks / test (3.10, lowest-direct, ubuntu-latest)	48s
checks / test (3.11, lowest-direct, windows-latest)	3m 19s
checks / test (3.10, highest, windows-latest)	3m 26s
checks / test (3.12, highest, windows-latest)	3m 29s
checks / test (3.12, lowest-direct, ubuntu-latest)	49s
checks / test (3.12, lowest-direct, windows-latest)	3m 18s
checks / test (3.13, highest, ubuntu-latest)	47s
checks / test (3.10, highest, ubuntu-latest)	48s
checks / test (3.13, lowest-direct, ubuntu-latest)	45s
checks / test (3.12, highest, ubuntu-latest)	55s
checks / test (3.13, highest, windows-latest)	2m 25s
checks / test (3.11, highest, windows-latest)	2m 25s
checks / test (3.11, lowest-direct, ubuntu-latest)	44s
all-green	4s
	30m 10s

Provide feedback