added more validator documentation