added documentation to the new validator