Rebuild the docs around tested examples; shrink README.v2.md to a pitch #3038

Job	Run time
checks / docs	39s
checks / pre-commit	42s
checks / readme-snippets	12s
checks / test (3.10, locked, windows-latest)	1m 35s
checks / test (3.11, locked, windows-latest)	1m 32s
checks / test (3.11, lowest-direct, windows-latest)	1m 47s
checks / test (3.10, lowest-direct, ubuntu-latest)	1m 6s
checks / test (3.10, lowest-direct, windows-latest)	1m 32s
checks / test (3.10, locked, ubuntu-latest)	1m 8s
checks / test (3.12, locked, windows-latest)	1m 39s
checks / test (3.11, locked, ubuntu-latest)	1m 7s
checks / test (3.12, lowest-direct, ubuntu-latest)	1m 10s
checks / test (3.14, lowest-direct, ubuntu-latest)	59s
checks / test (3.13, locked, ubuntu-latest)	1m 1s
checks / test (3.13, locked, windows-latest)	1m 39s
checks / test (3.14, lowest-direct, windows-latest)	1m 23s
checks / test (3.12, lowest-direct, windows-latest)	2m 0s
checks / test (3.13, lowest-direct, ubuntu-latest)	1m 7s
checks / test (3.11, lowest-direct, ubuntu-latest)	1m 6s
checks / test (3.12, locked, ubuntu-latest)	1m 10s
checks / test (3.14, locked, ubuntu-latest)	2m 3s
checks / test (3.13, lowest-direct, windows-latest)	1m 37s
checks / test (3.14, locked, windows-latest)	2m 17s
all-green	3s
	30m 34s

Provide feedback