Improving docs about validation

With some questions from our user mailing list
Done with 300f07c