a number of lint/docs/tool tweaks #892

Job	Run time
build (unit_tests, ubuntu-22.04, row_major, default_panic, clang)	3m 52s
build (unit_tests, ubuntu-22.04, row_major, default_panic, clang)	3m 52s
build (unit_tests, ubuntu-24.04, col_major, default_panic, clang)	2m 6s
build (unit_tests, ubuntu-24.04, col_major, default_panic, clang)	2m 6s
build (unit_tests, ubuntu-22.04, col_major, default_panic, gcc)	6m 56s
build (unit_tests, ubuntu-22.04, col_major, default_panic, gcc)	6m 56s
build (unit_tests, ubuntu-24.04, col_major, default_panic, gcc)	1m 46s
build (unit_tests, ubuntu-24.04, col_major, default_panic, gcc)	8m 18s
build (unit_tests, macos-13, col_major, default_panic, clang)	3m 29s
build (unit_tests, macos-13, col_major, default_panic, clang)	3m 29s
build (unit_tests, macos-14, col_major, default_panic, clang)	2m 16s
build (unit_tests, macos-14, col_major, default_panic, clang)	2m 16s
build (install_test, ubuntu-22.04, col_major, default_panic, clang)	1m 16s
build (install_test, ubuntu-22.04, col_major, default_panic, clang)	1m 16s
build (install_test, ubuntu-22.04, col_major, custom_handler, clang)	1m 13s
build (install_test, ubuntu-22.04, col_major, custom_handler, clang)	1m 13s
build (install_test, macos-14, col_major, default_panic, clang)	2m 26s
build (install_test, macos-14, col_major, default_panic, clang)	2m 26s
build (install_test, macos-14, col_major, custom_handler, clang)	2m 15s
build (install_test, macos-14, col_major, custom_handler, clang)	2m 15s
	1h 1m 42s

Provide feedback