WICKET-5341 JavaDoc for IFormValidator

Improve Javadoc to explain how to report an error.
Remove an old/obsolete TODO