docs: overhaul types #2033

Job	Run time
Build & verify package	14s
Verify dev env	11s
Check types using supported type checkers	16s
Tests & Mypy on 3.10	1m 7s
Run doctests & render changelog	18s
Tests on pypy-3.10	19s
Tests & Mypy on 3.14	1m 5s
Tests & Mypy on 3.13	1m 2s
Tests & Mypy on 3.12	1m 7s
Tests & Mypy on 3.11	57s
Tests & Mypy on 3.9	37s
Combine & check coverage	9s
required-checks-pass	4s
	7m 26s

Provide feedback