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

Job	Run time
checks / readme-snippets	12s
checks / docs	33s
checks / pre-commit	37s
checks / test (3.14, locked, ubuntu-latest)	2m 6s
checks / test (3.11, lowest-direct, ubuntu-latest)	1m 7s
checks / test (3.10, locked, windows-latest)	1m 41s
checks / test (3.11, lowest-direct, windows-latest)	1m 32s
checks / test (3.11, locked, ubuntu-latest)	58s
checks / test (3.13, lowest-direct, windows-latest)	1m 30s
checks / test (3.10, lowest-direct, windows-latest)	1m 23s
checks / test (3.12, lowest-direct, windows-latest)	1m 36s
checks / test (3.10, locked, ubuntu-latest)	42s
checks / test (3.11, locked, windows-latest)	2m 24s
checks / test (3.13, locked, ubuntu-latest)	53s
checks / test (3.14, lowest-direct, windows-latest)	1m 26s
checks / test (3.14, locked, windows-latest)	2m 30s
checks / test (3.13, lowest-direct, ubuntu-latest)	57s
checks / test (3.10, lowest-direct, ubuntu-latest)	1m 10s
checks / test (3.12, locked, ubuntu-latest)	1m 7s
checks / test (3.12, locked, windows-latest)	1m 30s
checks / test (3.13, locked, windows-latest)	1m 27s
checks / test (3.14, lowest-direct, ubuntu-latest)	55s
checks / test (3.12, lowest-direct, ubuntu-latest)	1m 9s
all-green	3s
	29m 28s

Provide feedback