Add docs, fix revert code, recommend #1503

Job	Run time
build-desktop (macos, development)	2m 7s
build-docker (macos-13)	16m 42s
build-desktop (macos, production)	2m 25s
build-docker (ubuntu-latest)	2m 8s
build-desktop (ubuntu, development)	1m 12s
build-desktop (ubuntu, production)	1m 13s
build-web (macos, development)	1m 9s
build-desktop (windows, development)	6m 54s
build-web (macos, production)	1m 16s
build-desktop (windows, production)	7m 1s
build-web (macos, test)	1m 27s
build-web (ubuntu, development)	1m 18s
build-web (ubuntu, production)	1m 17s
build-web (ubuntu, test)	1m 18s
build-web (windows, development)	6m 1s
build-web (windows, production)	6m 41s
build-web (windows, test)	7m 28s
	1h 7m 37s

Provide feedback