Added javadocs to proposed validator interface