more validation docs [skip ci]