update docs regarding validation [ci skip]