Improving docs about validation

With some questions from our user mailing list
Done