Update validation javadoc

org.onehippo.cms.services.validation.api.ViolationFactory: java doc of two methods have been switched. The javadoc should have an example of a variable definition in the message.

The javadoc about the subkey should have an example.