more validator documentation