further improvements to wizard flow and docs