Merge branch 'doc-reorg' into doc-index #1730

Job	Run time
linux/3.8/bare-env	9s
lint/style-and-typos	2m 55s
linux/3.12	43m 43s
osx/3.10	43m 47s
win/3.9	43m 35s
linux/3.11/conda	25m 40s
linux/3.10/mpi	8m 56s
linux/3.10/cython	24m 17s
win/3.8/pip	34m 56s
process-coverage-${{ matrix.TARGET }}	1s
	3h 47m 59s

Provide feedback