Updated JavaDoc to include example and further explanation of the class
level validation feature