more documentation for validator