Rebuild the docs around tested examples; shrink README.v2.md to a pit… #3060

Job	Run time
checks / docs	34s
checks / pre-commit	1m 13s
checks / test (3.11, lowest-direct, windows-latest)	1m 48s
checks / test (3.12, locked, windows-latest)	1m 45s
checks / test (3.10, lowest-direct, windows-latest)	1m 35s
checks / readme-snippets	15s
checks / test (3.11, locked, ubuntu-latest)	59s
checks / test (3.10, locked, ubuntu-latest)	1m 11s
checks / test (3.11, lowest-direct, ubuntu-latest)	1m 9s
checks / test (3.10, locked, windows-latest)	1m 39s
checks / test (3.12, lowest-direct, windows-latest)	1m 38s
checks / test (3.10, lowest-direct, ubuntu-latest)	1m 10s
checks / test (3.12, lowest-direct, ubuntu-latest)	1m 15s
checks / test (3.11, locked, windows-latest)	1m 36s
checks / test (3.13, lowest-direct, ubuntu-latest)	1m 8s
checks / test (3.12, locked, ubuntu-latest)	1m 23s
checks / test (3.14, lowest-direct, ubuntu-latest)	1m 0s
checks / test (3.13, locked, ubuntu-latest)	1m 2s
checks / test (3.14, lowest-direct, windows-latest)	1m 35s
checks / test (3.14, locked, windows-latest)	2m 20s
checks / test (3.14, locked, ubuntu-latest)	2m 5s
checks / test (3.13, lowest-direct, windows-latest)	2m 2s
checks / test (3.13, locked, windows-latest)	1m 41s
all-green	4s
	32m 7s

Provide feedback